









: La 


iprit ho 
 esaaeestl sempers 
| paaeesatsl - 
FA TIRES bisis 
is ies Sa T3 
gargari | 
pi eee ¢ sd 
giretti 
beu tess af Oe ~ 


nah be 










i sageseth LE -+ 
— et! MELELE FETI 
See Knenuesset eaucee t 
qerit epee eres PET eas 
— ; eeteety 


TESLA 

















: ——_ |. 
TE sees Ei | E i 
i j p ; = P m 
FA ps — RTE: eee a Ge al i 
eet T i- TER 
eee pos ea a | ei +7 | 
fee eee me hese eee 
1 | iet = ad ai a " IN DE 
i a5 i EF a TTT 71) A 
= a y i el = m 
eder a TT T T LL 
' ‘| RERE 
The SEERY 


Unreal Engine 4 Game 
Development Essentials 


Master the basics of Unreal Engine 4 to build stunning 


video games 


www.allitebooks.com 





PACKT 


Unreal Engine 4 Game 
Development Essentials 


Master the basics of Unreal Engine 4 to build stunning 
video games 


Satheesh PV 


| PACKT | 


PUBLISHING 
BIRMINGHAM - MUMBAI 


www.allitebooks.com 


Unreal Engine 4 Game Development Essentials 


Copyright © 2016 Packt Publishing 


All rights reserved. No part of this book may be reproduced, stored in a retrieval 
system, or transmitted in any form or by any means, without the prior written 
permission of the publisher, except in the case of brief quotations embedded in 
critical articles or reviews. 


Every effort has been made in the preparation of this book to ensure the accuracy 
of the information presented. However, the information contained in this book 

is sold without warranty, either express or implied. Neither the author nor Packt 
Publishing, and its dealers and distributors will be held liable for any damages 
caused or alleged to be caused directly or indirectly by this book. 


Packt Publishing has endeavored to provide trademark information about all of the 
companies and products mentioned in this book by the appropriate use of capitals. 
However, Packt Publishing cannot guarantee the accuracy of this information. 


First published: February 2016 
Production reference: 1220216 


Published by Packt Publishing Ltd. 
Livery Place 

35 Livery Street 

Birmingham B3 2PB, UK. 


ISBN 978-1-78439-196-6 
www. packtpub. com 


Cover image by Satheesh PV (mi ndfreak2040@gmai!. com) 


www.allitebooks.com 


Credits 


Author 
Satheesh PV 


Reviewer 
Omer Shapira 


Commissioning Editor 
Edward Bowkett 


Acquisition Editor 
Kevin Colaco 


Content Development Editor 
Deepti Thore 


Technical Editor 
Deepti Tuscano 


Copy Editor 
Merilyn Pereira 


Project Coordinator 
Dinesh Rathe 


Proofreader 
Uc Qu"Gf kipi 


Indexer 
Rekha Nair 


Graphics 
Jason Monterio 


Production Coordinator 
Aparna Bhagat 


Cover Work 
Aparna Bhagat 


www.allitebooks.com 


About the Author 


Satheesh PV is a game programmer living in Mumbai, India. He was selected by 
Epic Games as one of the closed beta testers for Unreal Engine 4 before its public 
release. He started his career as a game developer in 2012 by making a prst person 
multiplayer game with his brother and close friend using Unreal Development Kit. 
He also created Unreal X-Editor, which was an IDE developed for UnrealScript, 
the native scripting language of Unreal Engine 3. Heis also a moderator at Unreal 
Engine forums as well as a spotlight member and engine contributor. 


www.allitebooks.com 


Acknowledgements 


| am using this opportunity to thank God for giving me talent and a wonderful 
family, who are my real inspiration. | am grateful to them for their aspiring guidance 
and continuous support while writing this book. | am thankful to Epic Games for 
giving out such an amazing Engine to the world for free! You guys are the best! 


| express my warm thanks to my banc@ Gale Fernandes; without her amazing 
support and constructive criticism, this book possibly would not have happened. 


| would also like to thank my brother Rakesh PV for introducing me to the world 
of games and game technologies. It is through him | learned everything related to 
games and | am proud to say that he is my þrst mentor. 


| wish to extend my deep thanks and gratitude to my good friends Alexander 
Paschall (Epic Games) and Chance Ivey (Epic Games) and also to my best friend 
Reni Dev, with whom | created my prst game. 


| also wish to thank my dear friend and C++ mentor, Nathan Iyer (Rama) for his 
great support. With his amazing articles and examples on C+, he has taught many 
(including me) in the Unreal Community. He was kind enough to review my C++ 
chapter, point out mistakes and gave honest feedbacks including spending his 
valuable time to remove some technical discrepancies. Thank you so much Rama! 
You can visit his website at: http: //ue4code. com/ 


Finally, | would like to thank Vasundhara Devi and Lucy Fernandes for giving me all 
those joyous moments that put a smile on my face. Thank you moms! | love you. 


www.allitebooks.com 


About the Reviewer 


O mer Shapira is an artist, software developer, and virtual reality researcher. He 
has worked on Game Engine projects for Nike, Google, Microsoft, Disney, Universal 
Pictures, and Samsung. His projects and collaborations have been exhibited at 
Sundance Festival, The Atlantic, The New York Times, The Guardian, Wired, Adage, 
and Eyebeam, and have won awards from Tribeca Film Festival, Ars Electronica, the 
Art Directors Club, and The Webbys. 


Omer is currently head of virtual reality and game engines at Fake Love, an 
experiential design studio. Previously, he worked as a developer at Framestore, 
The NYU Media Research Lab, and the MIT Media Lab, and as a bImmaker and 
VFX artist for Channel 10. Omer studied mathematics at Tel Aviv University and 
human-computer interaction at New York University. 


Omer's four-dimensional video game, Horizon (written in Unreal Engine), will be 
released in 2017. 


You can pnd him atomershapira. com. 


I'd like to thank the people who contributed the most to my ability 
to write game engines: Ken Perlin, Casey Muratori, Jonathan Blow, 
Fred Ford, and Paul Reiche lll. 


I'd like to thank Surya M attu and Jenn Schiffer for being good 
parents, and my cat, Nitzu. 


www.allitebooks.com 


www.PacktPub.com 


eBooks, discount offers, and more 


Did you know that Packt offers eBook versions of every book published, with PDF 
and ePub bles available? You can upgrade to the eBook version at www. Packt Pub. 
comand as a print book customer, you are entitled to a discount on the eBook copy. 
Get in touch with us atcustomercare@packt pub. com for more details. 


Atwww. Packt Pub. com, you can also read a collection of free technical articles, 
sign up for a range of free newsletters and receive exclusive discounts and offers 
on Packt books and eBooks. 


pI PACKT 


https://www2.packtpub.com/books/subscription/packtlib 


D 


Do you need instant solutions to your IT questions? PacktLib is Packt's online digital 
book library. Here, you can search, access, and read Packt's entire library of books. 


Why subscribe? 


Å Fully searchable across every book published by Packt 
Å Copy and paste, print, and bookmark content 
Å Ondemand and accessible via a web browser 


www.allitebooks.com 





Table of Contents 


Preface vii 


Chapter 1: Introduction to Unreal Engine 4 1 
Unreal Engine 4 download 1 
Downloading the launcher version 2 
Downloading the GitHub version 3 

3 

5 

5 





Forking Unreal Engine repository 
Compiling Unreal Engine 
Getting familiar with Unreal Engine 


The viewport toolbar 8 
Modes 10 
Content Browser 11 
Content Browser view options 12 
World outliner 13 
Details panel 14 
Navigating the Viewport 14 
BSP 16 
Creating BSP 16 
Default starting level, splash screen, and game icon 17 
Summary 19 
Chapter 2: Importing Assets 21 
Creating asset in a DCC application 21 
Creating collision meshes 23 
Custom collision shapes 23 
Unreal Engine 4 collision generator 24 
Simple shapes 29 
K-DOP shapes 26 
Auto convex collision 26 
Materials 27 
LOD 28 


[i] 


www.allitebooks.com 


Tadleof Contents 


Exporting and importing 29 
Exporting 29 
Importing 30 

Context menu 30 

Drag and drop 30 
Content Browser import 31 
Automatic import 31 
EqoO whi "cwoo cve'lo r atv’ 53 
Result 32 
Summary 33 
Chapter 3: Materials 35 

Material user interface 36 

Toolbar 36 
Live preview 39 
Live nodes 40 
Live update 40 

Preview panel 40 

Details panel 4] 

Graph panel 42 

Palette panel 42 

Common material expressions 42 
Constant 43 
Constant2Vector 44 
Constant3Vector 45 
Texture coordinate (TexCoord) 46 
Multiply 46 
Add 47 
Divide 49 
Subtract 50 
Texture sample (Texture2D) 51 
Component mask 53 
Linear interpolate (lerp) 54 
Power 55 
PixelDepth 56 
Desaturation 59 
Time 60 
Fresnel 61 
Material types 62 
Material instances 62 

Material Instance Constant 62 


Material Instance Constant example 64 


[ii] 


Tadleof Contents 


Material functions 67 
Material function example 67 
Summary 75 
Chapter 4: Post Process 77 
Adding Post Process 78 
LUT 81 
Post Process Materials 82 
Creating a Post Process Material 83 
Summary 86 
Chapter 5: Lights 87 
Lighting basics 87 
Placing lights 88 
Various lights 89 
Common light settings 89 
Light mobility 91 
Lightmass Global Illumination 93 
Preparing your assets for precomputed lighting 97 
Building a scene with Lightmass 102 
Tweaking Lightmass settings 104 
Summary 113 
Chapter 6: Blueprints 115 
Different Blueprint types 116 
Getting familiar with the Blueprint user interface 117 
Components tab 118 
What are components? 118 
Adding a component 118 
Transforming the component 119 
Adding events for components 120 

My Blueprints tab 122 
Creation buttons 122 
Searching in my Blueprint 122 
Categorizing in My Blueprint 123 
Toolbar 124 
Graph editor 124 
Details panel 124 
Blueprint graph types 124 
Function graph 125 
Creating functions 125 
Graph settings 126 


Editing functions 127 


[ii] 


Tadleof Contents 


Macro graph 129 
Interface graph 131 
Blueprint node references 136 
Node colors 137 
Variables 138 
Math expression 138 
Etgcvpi 'qwt'OtuvDmor tipvercuu" 362 
Creating a new Blueprint 140 
Spinning static mesh 142 
Destroying our Blueprint Actor after some seconds 143 
Spawning our Blueprint class in Level Blueprint 144 
Summary 146 
Chapter 7: Matinee 147 
Creating a new Matinee 147 
Matinee window 149 
Manipulating an object 152 
Cutscene camera 160 
Director group 163 
Summary 165 
Chapter 8: Unreal Motion Graphics 167 
Setting up a project 167 
Creating the HUD Widget 170 
Creating the health bar 172 
Assigning our HUD to Character 175 
Etgcvipi 'Sqcvpi 'j genj "dctu" 399 
Summary 181 
Chapter 9: Particles 183 
Cascade particle editor 183 
Toolbar 184 
Viewport 185 
Navigation 186 
Details 187 
Emitter 187 
Emitter types 188 


Curve editor 188 


[iv] 


Tadleof Contents 


Creating a simple particle system 188 
Creating a simple material 189 
Adding gravity 193 
Applying the color over life module 195 
Adding collision module 196 

Playing particle in Blueprints 197 

Summary 199 

Ej cr vot'32<Wbviaf we "\Va'WotgcnE- - " 423 

Ugwoi 'wr "XkuwchUw 1q'4237" 423 
Y gtntay "lo r tgxgo gow" 425 

Etgcvpi 'c'E- - 'Y tqlgev' 426 
The character class 205 

Adding the health system 209 

C++ to Blueprint 215 

Summary 218 

Chapter 11: Packaging Project 219 

Recap 219 

Packaging the project 226 
Quick packaging 226 
Packaging the release version 229 

Summary 235 

References 236 

index 237 


[v] 


Preface 


The purpose of U nreal Engine 4 Game D evelopment Essentials is to teach people 
interested in using Unreal Engine how to create video games. You will learn what 
Unreal Engine is and how to download and use it. From there, we will go through 
the collection of tools available in Unreal Engine 4 including Materials, Blueprints, 
Matinee, UMG, C+, and more. 


What this book covers 


Chapter 1, Introduction to Unreal Engine 4, is where we begin our journey on U nreal 
Engine 4 Game D evelopment Essentials. In this chapter, the reader will learn how and 
where to download Unreal Engine as well as the difference between the source 
version and launcher version. After the Engine's installation (or compilation, if it was 
the source version) we will get comfortable with the user interface of Unreal Engine. 
We will also learn about the basics of Content Browser, BSP, and how to change the 
splash screen and the icons for your game. 


Chapter 2, Importing Assets, teaches how to import your custom FBX assets into 
Unreal Engine once we get the Engine up and running. You will learn about 
collisions, materials, and the level of detail. 


Chapter 3, M aterials, teaches you about the M aterial editor and some common nodes 
used to create shaders for your assets. After learning the basics of Material, we will 
create an example material function that can change the Intensity of anormal map. 


Chapter 4, Post Process, continues to post-processing after teaching you about 
materials. In this chapter, you will learn how to override the default post process 
settings. After that, we will learn how to add our own post process volume and learn 
a simple but very powerful feature called LUT. After that, we will create a special 
material that can be used with post process, and this material will have the ability 

to highlight user-depbned objects in the world. 
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Chapter 5, Lights, gets us halfway through our U nreal Engine 4 Game D evelopment 
Essentials journey, and this chapter will introduce you to the lighting system. We 
start of by covering the basics, such as placing lights and going through the common 
settings. You will then learn more about the Lightmass Global Illumination system, 
including how to properly prepare a UV channel for your asset to be used with 
Lightmass. By the end of this chapter, you will learn how to build your scene with 
Lightmass as well as Lightmass settings. 


Chapter 6, Blueprints, teaches you what Blueprints are and about the various types of 
Blueprints that are available in the Engine. Blueprints are Unreal Engine's number 
one tool that allows artists and designers to quickly prototype their game (or even 
make one!). You will also learn about the different graph types, such as event graph, 
function graph, macro graph, and so on, and how to spawn a Blueprint dynamically 
at runtime. 


Chapter 7, M atinee, looks at the cinematic side of Unreal Engine 4 and the tool 
associated with it, called Matinee. You will learn what Matinee is, how to create 
one, and get familiar with the UI. After the basics, we will learn how to manipulate 
objects in Matinee as well as create a very basic cutscene, which we will trigger 
using Blueprints. 


Chapter 8, Unreal M otion Graphics, teaches you to create a basic HUD that shows 

the health of the player. Unreal Motion Graphics (UMG) is the UI authoring tool in 
Unreal Engine. UMG is used to create Player HUD, Main Menu, Pause Menu, and so 
on. You will also learn how to create 3D widgets, which can be placed in the world 
or attached to an actor class. 


Chapter 9, Particles, looks at the extremely powerful and robust tool called cascade 
particle editor and creates a particle system, as no game is good without good visual 
effects. We then combine this with simple Blueprint scripting to create randomly 
bursting particles. 


Chapter 10, Introduction to Unreal C++, goes over C++ as we draw close to the end 

of our Unreal Engine 4 Game D evelopment Essentials journey. In this chapter, you will 
learn how to get Visual Studio 2015 Community Edition and learn the basics of C++ 
by inspecting the Third Person Template character class. We will then extend this 
class to add support for health and the health regeneration system. You will also 
learn how to expose variables and functions to Blueprint Editor. 


Chapter 11, Packaging Project, brings us to the end of our Unreal Engine 4 Game 

D evelopment Essentials journey. In this pnal chapter, we will recap all the things 
we've done, including a few tips, and þnally, you will learn how to create a release 
version of your game. 
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What you need for this book 


Unreal Engine 4.9 or higher 


Who this book is for 


This book is aimed at anyone who Is interested in learning game development using 
Unreal Engine 4. If you are passionate about developing games and want to know 
about the essentials of Unreal Engine 4 and its tools, then this book will get you up 
and running quickly. Unreal Engine 4 will be your next step towards creating next 
gen video games for all platforms, including mobile and consoles. 


Conventions 


In this book, you will pnd a number of text styles that distinguish between different 
kinds of information. H ere are some examples of these styles and an explanation of 
their meaning. 


Code words in text, database table names, folder names, blenames, ple extensions, 
pathnames, dummy URLS, user input, and Twitter handles are shown as follows: 
"This adds or removes a path (it can be a virtual package path such as\ Game \ 

My Cont ent\ or an absolute path such asC:\ My Contents ) for the engine to 
monitor new content." 


A block of code is set as follows: 


void APACKT CPPCharacter:: Regenerateneal.t ht) 
{ 

if (Health >= GetClass()->GetDefaultObj ect <ABaseCharacter>()- 
>Heal t h) 

{ 

Health = GetClass()->Get Default Obj ect <ABaseCharacter >()- 

>Heal th; 
} 
else 
{ 

Health += RegenerateAmount ; 

FTi mer Handle TimerHandle ReRunRegenerat eHealth: 

Get Worl dTi merManager().SetTimer( Ti merHandl e_ 
ReRunRegenerateHealth, this, &APACKT CPPCharacter:: Regenerat eHealth, 
RegenDelay ); 

} 
} 
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N ew terms and important words are shown in bold. Words that you see on the 
screen, for example, in menus or dialog boxes, appear in the text like this: "Once 
you log in, you can download the launcher by clicking on the big orange D ownload 
button under G et Unreal Engine." 


| Warnings or important notes appear in a box like this. | 


| Q Tips and tricks appear like this. | 


Reader feedback 


Feedback from our readers is always welcome. Let us Know what you think about 
this book—what you liked or disliked. Reader feedback is important for us as it 
helps us develop titles that you will really get the most out of. 


To send us general feedback, simply e-mail feedback @packt pub. com, and mention 
the book's title in the subject of your message. 


If there is atopic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide atwww. packt pub. com authors. 


Customer support 


Now that you are the proud owner of a Packt book, we have a number of things 
to help you to get the most from your purchase. 


Downloading the example code 


You can download the example code bles for this book from your account at 
http://www. packt pub. com. If you purchased this book elsewhere, you can visit 
http://www. packt pub. com/support and register to have the bles emailed directly 
to you. 
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You can download the code ples by following these steps: 


Log in or register to our website using your email address and password. 
Hover the mouse pointer on the SUPPORT tab at the top. 

Click on Code Downloads & Errata. 

Enter the name of the book in the Search box. 

Select the book for which you're looking to download the code ples. 
Choose from the drop-down menu where you purchased this book from. 


Au BF WN 


7. Click on Code D ownload. 


Once the ble is downloaded, please make sure that you unzip or extract the folder 
using the latest version of: 


A WinRAR/ 7-Zip for Windows 
Å Zipeg/ iZip/ UnRarX for Mac 
Å 7-Zip/ PeaZip for Linux 


Downloading the color images of this book 


We also provide you with a PDF ble that has color images of the screenshots/ 
diagrams used in this book. The color images will help you better understand the 
changes in the output. You can download this blefromht tp: // www. packt pub. 
com/sites/default/files/downl oads/ Unreal Engi ne4GameDevel opment 
Essentials Colori mages. pdf. 


Errata 


Although we have taken every care to ensure the accuracy of our content, mistakes 
do happen. If you pnd a mistake in one of our booksn maybe a mistake in the text or 
the code—we would be grateful if you could report this to us. By doing so, you can 
save other readers from frustration and help us improve subsequent versions of this 
book. If you pnd any errata, please report them by visiting http://www. packt pub. 
com/ submit - errata, Selecting your book, clicking on the Errata Submission Form 
link, and entering the details of your errata. Once your errata are veriped, your 
submission will be accepted and the errata will be uploaded to our website or 

added to any list of existing errata under the Errata section of that title. 


To view the previously submitted errata, go toht tps: // www. packt pub. com/ books/ 
content/support and enter the name of the book in the search pead. The required 
information will appear under the Errata section. 


[xi] 
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Piracy 

Piracy of copyrighted material on the Internet is an ongoing problem across all 
media. At Packt, we take the protection of our copyright and licenses very seriously. 
If you come across any illegal copies of our works in any form on the Internet, please 
provide us with the location address or website name immediately so that we can 
pursue a remedy. 


Please contact us atcopyright @packt pub. com with a link to the suspected 
pirated material. 


We appreciate your help in protecting our authors and our ability to bring you 
valuable content. 


Questions 


If you havea problem with any aspect of this book, you can contact us at 
questions @packt pub. com, and we will do our best to address the problem. 
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Introduction to Unreal 
Engine 4 


Welcome to U nreal Engine 4 Game D evelopment Essentials. In this chapter, you will 
learn how to download Unreal Engine's source version and launcher version. After 
that, we will get familiar with the Unreal Engine 4 UI and Content Browser. 


Unreal Engine 4 download 


Unreal Engine 4 is completely free (including all future updates!) to download and 
use. You get all the Unreal Engine tools, free sample contents, complete C+ source 
code which includes code for the entire editor, and all of its tools; you also get access 
to ofbcial documentation that includes tutorials and support resources, plus you get 
access to UE4 marketplace, which offers tons of free and commercial content. 


Unreal Engine 4 can be downloaded in two different versions. One is a binary 
version (launcher) and the other is the source version (GitH ub). The differences 
between the GitH ub and launcher version are as follows: 


Å Launcher (binary) version: These are compiled by Epic and are available 
through launcher. You will also get all source files (*. cpp ) with the launcher 
version, but you cannot make any modifications to Unreal Engine since 
launcher versions do not generate a solution file. 


Å GitHub version: These do not have any binary files so you have to compile 
the Engine yourself. You get the entire source and you can modify virtually 
anything in Unreal Engine. You can add new Engine features, modify 
existing features or remove them (which no one does), and create a pull 
request on GitH ub so if Epic likes it, they will integrate it officially into 
Unreal Engine. 


In this guide, l'II show you how to get both versions. 
[1] 
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Downloading the launcher version 


To download the launcher version of Unreal Engine, you obviously need the 
launcher. To download the launcher, follow these steps: 


1. Firstgotohttps:// www. unreal engine. com/ and login using your 
credentials. 


2. Once you log in, you can download the launcher by clicking on the big 
orange D ownload button under Get Unreal Engine. 


Download 
iu 


Get Unreal Engine Get Unreal Tournament Get UE4 Full Source Code 


Learn about Ps i i 
Lown ad Download to.chownioad the WES Source Code, 


of choose your platform: Yvi [m or choose your platlorm: v 


NEED HELP? 17 





When you open the launcher for the þrst time after installation, it should 
automatically download the latest version of Unreal Engine 4. If it doesn't, then go 
to the Library tab and click on Add Engine. A new Engine slot will now appear and 
here, you can select your Unreal Engine version and install it. 


EPN Unreal Engine 


MEWS. 
Learn 
Marketplace 


Library 


i Forums 


G Answerhub 
= 


w Rowimap 
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Downloading the GitHub version 
To download the source of Unreal Engine 4, follow these steps 


1. First create a GitH ub account (it's free!). 


2. After that, you need togotohttps:// www. unreal engine. com dashboard/ 
settings and update your GitHub account name and click on Save: 


English 





Forking Unreal Engine repository 


After you have successfully linked your GitH ub account with your Unreal Engine 
account, you need to log in to GitHub and navigate to the Unreal Engine repository. 


M ake sure you have linked your GitH ub account to your Unreal 
ON Engine account. Otherwise, you will not be able to see the Unreal 
, Engine repository. 


[3] 
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When you are at the repository page: 


1. Click on Fork atthe top right of the page. 
2. Select your username to fork it to your GitH ub repository. 


3. Then, you need to download GitH ub for Windows (if you are on Windows) 
or GitHub for Mac (if you are on Mac) and install it. 


You need this Git client to clone (download) your forked repository, make your 
own changes to Unreal Engine, and submit the changes as a pull request to Epic to 
integrate them into the editor. 


To clone your forked repository follow these steps: 


1. Start GitHub and log in using your credentials. 

2. Click on the plus (+) sign on the top left corner of the Git client. 

3. Then, click on the Clone tab and select your username (you should now 
see Unreal Engine). 

4. Now, click on Clone Unreal Engine and choose a folder where you want to 
save your Unreal Engine repository. 

5. Click onOK. 
You should now see GitH ub cloning Unreal Engine to your hard disk. 


master v 


Add Create Clone 
—— Files to commit 


rivate\AssetContextMenu.cpp 
Y Graph Engine\Source\Editor\ContentBrowser\Private\AssetContextMenu.h 


E RTS-Commun ty-Project 
ywser\Private\SAssetView.h 


H UE4-Map-Editor 


Engine\Source\Editor\ContentBrowser\ Priv 
4 UnrealEngine Engine\Source\Editor\ContentBrowser\Private\SContentBrowser.cpp 
Engine\Source\Runtime\SlateCo 








eCore\Public\Widgets\SWidget.h 


{v ) Clone UnrealEngine 


re Added workarounds tor Adreno Z2xx GPU ©... 
Chris Babcock 
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Once cloning is complete, navigate to that directory and run theSet up. bat ple 


1. This will download all the necessary ples that are needed to compile the 
engine and will also install all the required prerequisites for the Engine. 


2. This might take sometime depending on your Internet speed because it has 
to download more than 2 GB of bles. 


Compiling Unreal Engine 

OnceSetup. bat has pnished, runGenerateProjectFiles. bat, which will generate 
the Visual Studio Solution ple. Open theUE4. sIn ple and now, you areall set 

to compile your own copy of Unreal Engine4 . Now, right-click on UE4 in the 
Solution Explorer and click on Build. 


Solution Explorer 
A o-Sakh £|—= 


fa] Solution 'UE4' (50 projects) 


4 fm] Engine 
+. ea 
UnrealVS Quick Build » ?P Programs 
iy Build 


Rebuild 





This will take from 15 minutes to 1 hour depending on your system hardware. So sit 
back, grab a cup of coffee, and wait till Engine pbnishes compiling. 


Getting familiar with Unreal Engine 


Once your Engine pnishes compiling (or downloading, if you are using launcher) 
it's time to start it: 


Å Starting your custom build: You can either press F5 in Visual Studio 
to start debugging the Engine or navigate to the directory where you 
downloaded it and goto Engi ne\ Bi nari es\ Wi n64 folder and double-click 
ONUE4SEdi tor.exe. 


Å Starting launcher build: Simply click on that big Launch button and you're 
good to go. 


—___—_—_—_————————. [5] 
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_ You might experience long loading time when you start the 
Engine for the prst time after compiling. This is because Unreal 
7 Engine will optimize the contents for your platform to derive 

data cache. This is a one-time process. 


After the splash screen, you should now see the Unreal project browser. Perform the 
following steps: 


L. 
2. 


Select the N ew Project tab, and this is where you create your new projects. 


For this book, we will stick with a Blank Blueprint Project. So, in the 
Blueprint tab, select Blank project. 


You can choose which platform you want for your project. There are two 
platforms available: D esktop/C onsole and M obile/Tablet. Feel free to 
change this setting for your project. The second setting determines the 
graphics settings for your platform. If you choose D esktop/C onsole, it's 
better to stick with Maximum Quality and if your project is targeting 

M obile/T ablets, you should choose scalable 3D or 2D, which is aimed at 
low-end GPUs. The third and þnal setting lets you add some Starter Content 
from Epic, which contains some basic meshes, materials, and textures. Y ou 
can choose not to include Starter C ontent so the project will only contain 
essential elements for the selected project. 


N ote that it is not recommended to include Starter C ontent when creating 
a project for the M obile/T ablet platform. This can signifpcantly increase the 
package size of your project. 


Choose a name for your project and the location where you want to save it. 
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6. Finally, click on Create Project to start Unreal Engine 4 with your project: 


AL Unreal Project Browser 


Projects New Project <- 1 


First, choose a template to use as a starting point for your new project 


@B Blueprint og C++ 


~a To ; i e 


Flying Rolling Side 
Scroller 


y ree ss Wg 
á 4 e E N O 4 
—— 


2D Side Top Down Twin Stick Vehicle Vehicle >. 


Scroller Person Shooter Advanced 


Blank 


A clean empty project with no code. 


Next, choose some settings for 


Desktop / Console Maximum Quality With Starter Content 


Finally, choose a location for your project to be stored 


4 > C:\Users\pv\Documents\Unreal Projects oo 


Folder Name 





This is how the Unreal Engine user interface looks: 


u 
re 
P/ ex 

CE 


Recently Placed 


MCreate-~ Alimport gM Save All 


T= Game » 
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Once Unreal Engine starts up, you should see a scene similar to the preceding 
screenshot. This is the scene that will be displayed by default, if you choose to 
include Starter Content. If you skip Starter Content, then the startup scene 
will be different. 


The viewport toolbar 


The viewport toolbar contains various tools that you will use throughout your level 
design process. Let's take a quick look at them: 





Å Transform Tools: These three tools are the move tool, the rotate tool, and the 
scale tool. 


A Coordinate System: This allows you to move, rotate, or scale your Actor 
either on world axes (world space) or on its own local axes (local space). By 
default, Unreal editor starts in world axes but you can toggle by clicking on 
the icon. The globe icon means world space and the cube icon means local 
space. 


Å Snapping and M ove Grid: Snapping allows you to snap one A ctor to 
another Actor's surface, and move grid allows you to snap to a three- 
dimensional implicit grid within the scene. 


Å Rotation Grid: This provides incremental rotation snaps. 
Å Scale Grid: This snaps to additive increments. 


A Snapping preferences for move, rotate, and scale can be adjusted 
Q in Editor Preferences. Go to Edit | Editor Preferences | 
Viewports and then scroll to Grid Snapping Category. 


Jo 


Camera Speed: This lets you control how fast the camera moves In viewport. 


my You can pne-tune the camera speed by holding down the right mouse 
Q button (while using WASD controls) and scrolling the mouse wheel 
up or down to speed up or slow down the camera's movement. 
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A Maximize Viewport: This toggles between a single viewport and a 4-view 
split style. 


You can adjust the layout of Viewport by changing the Layout 
option, as shown in the following screenshot: 


oen 


Viewport Options 
|| # Realtime 
| Show Stats 
| Show FPS 
Stat b 
Fieldof View [EDR a 


Wi Allow Matinee Preview 
| Game View 
| | Immersive Mode 
Lock Viewport to Actor 
Bookmarks 


Create Camera Here 


High Resolution Screenshot... 


Advanced Settings... 





Later in this chapter, you will learn how to use Binary Space Partitioning (BSP) and 
change some project settings such as Splash screen, game Icon, and so on. 
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Modes 


The M odes tab contains all bve modes of the editor. They areas follows: 


A 


Place mode (shortcut key is Shift +1): Place mode allows you to quickly 
place your recently placed objects and also Engine primitives such as lights, 
geometries, triggers, volumes, and so on. 


Paint mode (shortcut key is Shift +2): Paint mode (also Known as Mesh 
Paint) allows you to interactively paint vertex colors on Static M esh in Level 
Viewport. 


Landscape mode (shortcut key is Shift +3): Landscape mode lets you create 
anew landscape entirely in Unreal Editor or import a height map from an 
external program, such as World M achine, TerreSculptor, and so on, and 
make modifications to it. 


Foliage mode (shortcut key is Shift +4): Foliage mode allows you to paint or 
erase multiple static meshes on Landscapes, other static meshes, and so on. 
An example workflow is to paint grass, trees, and so on on a large area. 


Geometry Editing mode (shortcut key is Shift +5): Geometry mode allows 
you to edit BSP brushes. 


Fa Modes 


AA 


Recently Placed Cameri 
Basic 
Lights Wa slayer Start 
Visual eet 
Point Light 

BSP 
Volumes | Box Trigger 
All Classes 

| Sphere Trigger 


Capsule Trigger 


“J Target Point 
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Content Browser 


Content Browser is what you call the heart of your project. This is where you 

create, import, view, edit, organize, and modify all the assets for your game. 

It also lets you rename, delete, copy, and move assets across other folders just like 
you do in Windows Explorer. Additionally, Content Browser also lets you search for 
speciþc assets based on keywords or asset type and you can exclude assets from your 
search by adding '-' (hyphen) as the prepx. 


You can also create Collections to arrange your commonly used assets for 
quick access. 


RS. Collections are just references to assets and are not moved into 
Q collections. That means a single asset can exist in multiple collections 
and you can create an unlimited number of collections. 


There are three types of collections: 


Å Shared collection: These are visible to you and to other users. This option is 
active only if you have Source Control (for example: Perforce, Subversion 
and so on.) enabled. 


Å Private collection: These are visible only to those who are invited to view the 
collection. This option is active only if you have Source Control (for example: 
Perforce, Subversion and so on.) enabled. 


Å Local collection: These are only for you. That means they only exist on your 
local machine. 


If you want to transfer an asset from one project to another, you can right-click on 
the asset and choose M igrate... , which will copy that asset and all its dependencies 
to your new project. 


Content Browser can be accessed by pressing Ctrl+Shift+F or from the Windows 
menu on the menu bar. You can also have four instances of Content Browser at the 
same time. 
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This can be really useful when you want to move assets to different folders or to 
preview various assets in different folders. 


= Content Bowser, 


t Create ~ jimport Save All 


ka 
Search Game pD 


> EACE 


Starter 
Content 


ve F 
Collec 1 item €> View Options + 





Content Browser view options 
View options lets you do the following: 


Å Change the thumbnail size 
Å Changetheview style 
Å Modify the 3D thumbnail, and more 


[12] 


Chapter 1 


View Options can be accessed from the bottom-right corner of Content Browser. 


Columns 
Folders 
| Show Folders 


|_| Show Developers Folder 


_| Show Plugin Content 


|_| Show Engine Content 


_| Show Collections 
Thumbnails 
el 
| Thumbnail Edit Mode 


“| Real-Time Thumbnails 





World outliner 


World Outliner shows all the Actors within the level in a tree view. Actors can be 
selected and modibed from world outliner. Right-clicking on an Actor in World 
Outliner will show the same context menu used in Viewport so you can modify it 
without having to navigate to them in Viewport. You can drag an Actor to another 
Actor and attach them together. 
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World outliner allows you to search for a specipc Actor. You can exclude a speciþc 
Actor by adding - (hyphen) before the search term and you can force a term to match 
exactly by adding + before the search term. 


= World outiner 


ah. 


Label Type 
ce 42 Example Map World 
c+ df NavData Folder 
š LS NavMeshBoundsVolume NavMeshBounds\ 
© RecastNayMesh-Default RecastNavMesh 
© AbstractNavData-Default AbstractNayData 
a Example Map Level Blueprint 
= GlobalPostProcessVolume PostProcessVolur 
PlayerStart Playerstar 
PlayerStart? Si 
PlayerStart3 Playerstan 
“a. SkyLight SkyLight 
T SM Template Map_Floor StaticMeshActor 


ii, 


c) A 5 


6) 


i 
‘eel 


= 
1 E 


9 actors @> View Options + 





Details panel 


The D etails pane! shows all the information, utilities, and functions speciþc to the 
selection in the viewport. It displays all the editable properties for the selected Actor 
and provides additional functionality based on the selected A ctor. For example, if you 
select a Blueprint, the D etails panel will show everything related to that Blueprint, 
that is exposed variables, Blutility events, and so on. If you select a Static M esh actor, 
the Details panel will show which material was applied, the collision settings, the 
physics settings, the rendering settings, and more. The D etails panel can be locked 

to the selected Actor so it does not change based on Actor selection. Just like Content 
Browser, you can have four instances of D etails pane! open at the same time. 


Navigating the Viewport 


You can navigate the viewport easily using the mouse and keyboard. 

A high-level explanation of navigating the viewport can be found here: 
https://docs.unrealengine.comlatest/INT/Engine/Ul/LevelEditor/ 
Viewports/ViewportControls/index. html 
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A! At the bottom-left corner of the viewport, there is a small 
Q question mark button. If you click on that, you will see some 
commonly used viewport shortcut keys. 


Navigation 


Perspective Viewport 


Move forward / 


backward 

Rotate left / right 
Free Rotate 
Move up / down 


Zoom in out 


LMB + Drag up / dovm 


LMB + Drag left / right 
RMB + Drag 
LMB + RMB + Drag 


Mouse Soroll Wheel 


Top / Front / Side Viewport 


Pan 


Zoom inf out 


Select 
Toggle selection 


Marquee 
Selection 


Clear Selection 


Focusing 


Focus selected 
object 


RMB + Drag 


LME + RMB + Drag 
or 
Mouse Scroll Wheel 


LME on Actor 
(Ctrl + LMB on Actor 


LMB + Drag 


LMB = Left Mouse Button 
RMB = Right Mouse Button 
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BSP 


Now that we have some solid understanding of Engine UI, let's use BSP to create 

a simple level. BSP is a geometry tool (also known as Geometry Brush or simply 
Brush) used for quickly prototyping levas (also Known as blocking out levels). Some 
developers prefer to call this Constructive Solid Geometry (CSG ), which is the more 
accurate term since geometry in Unreal editor is created by adding and subtracting 
brushes. BSP has been there since the þrst release of Unreal. It was used for level 
designing long ago but later, this role has been passed to static meshes because BSP 
IS more expensive in performance. 


So basically, BSP should only be used to prototype a level. Once you have the basic 
idea of how a level should look, you should start replacing it with static meshes. 


al 


` CSG and BSP are used interchangeably to refer the 
geometry in Unreal. Both are the same. 


Creating BSP 


Unreal Engine 4 comes with seven Brushes and all of them can be customized in 
D etails panel. They areas follows: 


Å Box: You can adjust thexX , Y, and Z axes and set it to Hollow, which is a fast 
way to make a room, and adjust Wall Thickness, which defines the thickness 
of the inside walls. 


Å Cone: You can customize the number of sides, height, and both outer and 
inner radius in Details panel. You can also set this to Hollow and adjust 
Wall Thickness to define the thickness of the inside walls. 


Å Cylinder: You can customize the number of sides, height, and both outer 
and inner radius in Details panel. You can also set this to Hollow and adjust 
Wall Thickness to define the thickness of the inside walls. 


Curved Stair: This creates a staircase shape that bends around an angle but 
cannot wrap over itself. 


Linear Stair: This creates a straight staircase that does not bend. 


Spiral Stair: This creates a spiral staircase that can repeatedly wrap 
over itself. 


D> > > D> 


Sphere: This creates a sohere shape. The radius can be customized in 
D etails panel. 
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Just like any other actor, you can use Transform Tools to move, rotate, and scale as 
you see pt. 


There are two types of Brushes. They areas follows: 


Å Additive: These brushes are solid. This will add geometry to the level. For 
example, you will use the Additive type to create walls, floors, ceilings, and 
so on. 


Å Subtractive: These brushes are hollow. This will subtract solid space 
from a previously created Additive brush. For example, you will use the 
Subtractive type to create windows or doors on walls. 


You can also convert BSP geometry to Static M esh and save them in Content 
Browser, but remember, they will have no UVs or additional M aterial elements. 
Itis also worth mentioning that this is not a good or recommended workyow. 
You should only use BSP to block out your level and later, you should import 
your assets created from a DCC application. 


al 


E You can go to Geometry Editing mode (Shift+# 5) to edit 
vertices and create a custom shape. 


Default starting level, splash screen, and 
game icon 


You can change the default starting level for both the game and editor. For example, 
for the game you may want the M ain M enu map as the default and for editor you 
want another level as the default startup level. 


It's easy to set them in Unreal editor: 


1. Click on Edit in the menu bar. 
2. Click on Project Settings. 
3. Goto Maps & Modes. 
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4. Here, you can change the game and editor default map. 


Eese ZB 2. ee ee 


v || 9 Perspective || © Lit || Show | 





u Proectertinmip 


Project Project - Maps & Modes 


> Måns & Mode 


Engine lor Startup Map /Engine/Maps/Templates/Template Default fæ] 
A y tam 





You can adjust Splash screen through Project Settings: 


1. Goto Windows sections. 
2. Change the Splash screen and the game Icon from here. 


al 


s The default dimensions for Splash screens are 600 x 200 and requires 
Q a .bmp image. The game Icon requires a 256 x 256. | CO ple. 
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Pidan: ; seie 


Platforms - Windows 


Engine 


Al System 


4 Splash 


Editor Splash 


Platforms 


Android 





Summary 

Now that you understand the basics of Unreal Engine, it's time to import some assets 
from a DCC application such as 3ds Max, Maya, or Blender. In the next chapter, 

we will create a simple mesh in 3ds Max and import it into Unreal Engine and go 
through various options, such as setting up materials, collisions, and LODs. 
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Importing Assets 


In the previous chapter, you learned the basics of Unreal Engine. In this chapter, you 
will learn about importing assets from Autodesk 3ds Max. 


Creating asset in a DCC application 


In the previous chapter, you learned how to use BSP to block out a level. 

However, weneed to replace them with static meshes for better performance and 
more control of materials, collisions, and so on. We will create models in the D igital 
Content Creation (DCC) application (such as Autodesk 3ds Max, Autodesk Maya, 
Blender, and so on) that are imported into Unreal Engine through Content Browser. 
Unreal Engine supports the import of both FBX and OB} but its recommended to use 
the FBX format. 
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The following screenshot is an example asset that | will use in this chapter: 





> Note that at the time of writing this book, Unreal Engine import pipeline 
uses FBX 2014. Trying to import using a different version might result in 
Incompati bilities. 


A few things that you need to keep in mind when modeling are as follows: 


Å Units: Unreal Units (UU) are critical when modeling assets for games. 
Incorrect units will result in assets looking larger or smaller than they are 
supposed to look. 1 Unreal Unit is equal to 1 cm. The sample character that 
comes with Unreal Engine 4is 196 cm high. So when you are modeling assets 
for Unreal Engine 4, it's best to use a box that is 196 cm high as reference. 


To learn how to change units for Autodesk 3ds Max, you can refer to 

https://knowl edge. autodesk. com support/ 3ds-max/|earn- 

explore/caas/CloudHel p/ cl oudhel p/ 2015/ ENU/ 3DSMax/ 
files/ GUI D- 69E92759- 6CD9- 4663-B993- 635D081853D2- htm. 
—— html. 


To learn how to change units for Blender, you can refer toht tp: / / www. 
katsbits.com/tutorials/blender/metric-imperial-units. 
php. 
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Å Pivot Point: This represents the local center and local coordinate system of 
an object. When you import a mesh into Unreal Engine, the pivot point of 
that mesh (as it was in your DCC application) determines the point where 
any transformation (Such as move, rotate, and scale) will be performed. 
Generally, it is best to keep your meshes at origin (0, 0, 0) and set your pivot 
point to one corner of the mesh for proper alignment in Unreal Engine. 


Å Triangulation: Remember that, the Unreal Engine importer will 
automatically convert the quads to triangles so there is no skipping 
from triangles. 


Å UV:When you do UVs for assets, you can go beyond the 0-1 space, especially 
when you are dealing with big objects. UV channel 1 (which is channel Oin 
Unreal) is used for texturing and UV channel 2 (which is channel 1 in Unreal) 
is used for lightmaps. 


Creating collision meshes 


You can create collision meshes and export them with your asset. Unreal Engine 4 
provides a collision generator for static meshes but there are times when we have to 
create our own custom collision shapes especially if the mesh has an opening (Such 
as doors or walls with window cutouts). In this section, we will see both options. 


i np . m 
~ Collision shapes should always stay simple because it is much 
faster to calculate simple shapes. 


Custom collision shapes 


Collision meshes are identiped by Unreal importer based on their names. There are 
three types of collision shapes that you can depne. They areas follows: 


A UBX_MeshName: UBX stands for Unreal Box and as the name says, 
it should bein a box shape. You cannot move the vertices in any way 
or else it will not work. 


A USP_MeshName: USP stands for Unreal Sphere and as the name says, it 
should bein the sohere shape. The number of segments of this sohere does 
not matter (although somewhere around 6-10 seems to be good) but you 
cannot move any vertices around. 
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A UCX M eshN ame: UCX stands for Unreal Convex and as the name says, it 
should be a convex shape and should not be hollow or dented. This is the 
most commonly used collision shape because basic shapes such as boxes 
and spheres can be generated right inside Unreal. 


In the following screenshot, you can see the red wireframe object, which is what | 
created for the collision shape: 





Unreal Engine 4 collision generator 


Collision shapes for static meshes can be generated inside the static mesh editor. 
To open this editor, double-click on a static mesh asset in Content Browser and 
click on the Collision menu, which will then list all the options for Collision. 
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File Edit Asset Mesh | Collision | Window Help 


=" O) Add Sphere Simplified Collision = 
E f 8) Add Capsule Simplified Collision CI) y 


Save FindinCB Realtimt Add Box Simplified Collision Bounds olsoni Show Pivot Normals Tangents Binormals 


Add 10DOP-X Simplified Collision 
LOD: 0 £ TTS TA 
Current Screen Size: 0.2156] Add 10DOP-Y Simplified Collision 
Triangles: 108 Add 10DOP-Z Simplified Collision 
Vertices: 96 


UV Channels: 2 E SS ee 
Approx Size: 256x256x256 Add 26DOP Simplified Collision 


Add 18DOP Simplified Collision 


Num Primitives: 1 Convert Boxes to Convex 


Remove Collision 


Copy Collision from Selected Static Mesh 


Opens the Auto Convex Collision Tool for generating a new convex collision mesh, or meshes. 





Simple shapes 


The prst three options in this menu are simple shapes and they areas follows: 


Å Sphere Collision: This creates a simple sphere collision shape 
Å Capsule Collision: This creates a simple capsule collision shape 
Å Box Collision: This creates a simple box collision shape 
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K-DOP shapes 


K Discrete Oriented Polytope (K-D OP) shapes are basically bounding volumes. 
The numbers (10, 18, and 26) represents the K-axis aligned planes. 


Auto convex collision 


This option is used to create much more accurate collision shapes for your models. 
Once you click on this option, anew dock window appears at the bottom-right 
corner of static mesh editor; using M ax Hulls (the number of hulls to be created 

to best match the shape of the object) and M ax Hull Verts (which determines the 
complexity of the collision hulls) you can create more complex collision shapes for 
your Static M esh. 


As you can see in the following screenshot, the auto convex result is reasonably 
accurate: 





Collision shapes support transformation (move, rotate, and scale) 
A! and you can duplicate them to have multiple collisions. Click on 
Q the collision shape inside static mesh editor and you can switch 
between move, rotate, and scale using W, E, and R. You can use 
Alt +left click drag (or Ctr! +W ) to duplicate an existing collision. 
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Materials 


Unreal Engine can import materials and textures to apply to the mesh while 
exporting from 3D application. From Autodesk 3ds Max, only the basic materials 
are supported. They are Standard and M ulti/Sub-O bject. In those basic materials, 
only speciþc features are supported. This means FBX will not export all settings but 
it Supports certain maps or textures used in that material type. 


In the following example, you can see a mode! with multiple materials assigned. 


N ote that it is very important to have unique names for each sub 
material in the M ulti/Sub-O bject material. Each sub material has a 
unique name as shown in the following screenshot: 


Modes Materi Options ilities 
[7 NJ 

oD 2 
N A f 


FT Ae a 8 m: 
ai Multi/Sub-Object 


Multi/Sub-Object Basic Parameters 


B Set Number Add Delete 
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LOD 


Level of Detail (LOD) is a way to limit the impact of meshes as they get farther away 
from the camera. Each LOD will have reduced triangles and vertices compared to 
the previous one and can have simpler materials. That means base LOD (LOD 0) will 
be the high quality mesh that appears when the player is near. As the player goes 
farther from that object, it will change to LOD 1 with reduced triangles and vertices 
than LOD 0 and as the player goes even farther away it will switch to LOD 2, which 
has much fewer triangles and vertices than LOD 1. 


The following þgure should give you an idea about what LOD does. The mesh on 
the left is base LOD (LOD 0), the middleisLOD 1, and theright isLOD 2. 


More information about LODs can befound athttps://docs. | 


| unrealengine.com/latest/INT/Engine/Content/Types/ 


StaticMeshes/HowTo/LODs/index. html. 
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Exporting and importing 


We will now cover how to export and import a mesh into Unreal. 


Exporting 

Exporting a mesh is a pretty straightforward process. You can export multiple 
meshes in a single FBX ble or export each mesh individually. Unreal importer can 
import multiple meshes as separate assets or combine them as a single asset by 
enabling the Combine M eshes option at import time. 


In the following screenshot, you can see that | have selected both the collision mesh 
and the model for exporting: 


oe se 


TEESE 


j 


FBX File Format 
Bye Binar y 


SEMIH BX 2014 Ne 
tod ications and 2014 FBX plug-ins 


014 applic 








Information 





Smoothing Groups should beturned on when exporting, 
otherwise Unreal Engine will show a warning when importing. 
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Importing 
Importing a mesh into Unreal is simple. There are three ways you can import. 
They are explained here. 


Context menu 


You can right-click inside Content Browser and select Import to <Your folder 
name>. 


Al LOD _TestMap —) Goptenesrouser 
BAddNew~ $ Import Œ SaveAll é | & Content » StarterContent » Shapes » 


p YFilters~ E 


4@ Content 
4 Š StarterContent 
@ Materials 
= . 


@ Textures 
#8 New Folder 
Shape_Cube W, New C++ Class 


p- 


Imports an asset from file to this folder. 


AR Blueprint Class 


BO Level 
= Material 


M Particle System 
d } 


Animation 


Blueprints 





Drag and drop 


As the name states, you can easily drag a FBX or OB) model from Windows Explorer 
to Content Browser to import. 
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Content Browser import 
Content Browser has an Import button that you can use to import meshes. 


Al LOD TestMap | = Content Browser 


PEET A a EEU € | & Content » StarterContent » 


Saarch Folders Import to /Game/StarterContent/Shapes... 





Automatic import 


If you place FBX ples in your project's Content folder (including any subfolders), 
Unreal will automatically detect this and trigger the import process (if you have 
the editor open. Otherwise, the next time you run it). 


EqpO wipi 'cwoo cve'lo r qtv 
You can choose whether you want this option enabled or disabled. To conpbgure, 
go to Edit | Editor Preferences | Loading & Saving | Auto Reimport. 


General - Loading & Saving 


Level Editor 


VIewport 


Content Editors 


Bhuepeint Ed 


Graph Editor 
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Å Monitor Content Directories: This enables or disables automatic importing 
of assets. 


Å Directories to M onitor: This adds or removes a path (it can be a virtual 
package path such as\ Game\ MyCont ent \ or an absolute path such 
aSC:\My Contents) for the engine to monitor new content. 


Å Auto Create Assets: If enabled, any new FBX files will not be automatically 
imported. 


Å Auto Delete Assets: If enabled, and you delete the FBX file from Explorer, 
Unreal Engine will prompt whether you want to delete the asset file as well. 


Result 


When you import your asset, you will see the Import O ptions dialog. You can read 
all about the import settings here: 


ais FEX Import Options Sear 


Current File: /Game/StarterContent/Shapes/Tower_Example 
4 Mesh 
Import as Skeletal ie 


to Generate Collisio 
Auto Generate Collision BR 


Static Mesh LODGroup None | 
Vertex Color Import Op 
Remove Degenerates 
Generate Lightmap UVs 
One Convex Hull Per Ut 
Import Mesh LODs ia 


PRC Import Normals. -w 


Combine Meshes 


4 Transform 
b Import Translation | CHESS 00 fz 00 
b Import Rotation Roll 0.0 a [Pitch 0.0 a 


Import Uniform Scale 1.0 i” 
4 Material 
Import Materials 


Import Textures 


Miscellaneous 
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Once you click on Import (or Import All if you're importing multiple FBX bles) you 
will see the asset in Content Browser. In the following screenshot, see how Unreal 
automatically imported the material from Autodesk 3ds M ax: 


Top_Cones TowerExample Woods 





If you double-click on the static mesh (Tower_Example), you will see the static mesh 
editor. In the following screenshot, you can see that Unreal successfully imported my 
custom collision shape too. 





Summary 


In the next chapter, you will learn more about M aterials and Textures. 
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Materials 


Material is an asset that debnes the look of a mesh with various graph nodes that 
include images (textures) and math expressions. Since Unreal Engine 4 utilizes 
Physically Based Rendering (PBR), creating realistic materials such as metal, 
concrete, bricks, and so on, can be quite easy. Materials in Unreal Engine depne 
everything about the surface of the mesh, such as its color, shininess, bumpiness, and 
tessellation, and can even animate objects by manipulating the vertices! At this point 
you might think Ok, M aterials are only used for meshes but, no, they are not actually 
limited to meshes. You use Materials for decals, post process, and light functions too. 


Creating a Material is a pretty straightforward process. All you have to do is 
right-click in Content Browser, select M aterial, and give it a name. Done! 


HEFemole 


aar Normal 
EME: Fo- TE 
4 Physical Material 

Pry Nope ae D 


4 Material 


Plain 


al D Amben edus 


Bere 
Decal I 


Celauli La + 





[35] 


Materials 


Material user interface 


Now that we know what a Material is and what it does, let's take a look at the user 
interface of M aterial graph. 


m Era nai 


4 Atmoaphere 
AInmosp 


M M_Erample 
Hase Color 
> Metallic 


Specular 


Wod Position Offset 
4 Physical Maternal 


Pies k Nutor qe (9 


a Material 
Gazai | 7 


D Mi i r hiru P 
Be E Dermul Lit = 





Toolbar 


The Toolbar panel contains various buttons that help to preview graph nodes, 
remove isolated nodes, M aterial stats, and so on. Let's take a look at what these 
buttons do: 


Å Save: Applies the changes you made to the Material and saves the asset 
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Find in CB: Navigates and selects this Material in Content Browser 


© 


Find in CB 





Apply: Applies the changes to the Material. Note that this will not save the 
Material 





H ome: N avigates to and selects the main canvas node 


Home 





Clean Up: Removes unconnected nodes 





Clean Up 
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Å Connectors: Shows or hides unconnected pins 





A 
A 
B- 
Live Nodes 
Å 
Live Update 
Å Stats: Toggles Material stats and compilation errors 


Å Mobile Stats: Same as stats but for mobile 


K) 


Stats Mobile Stats 





Live nodes might be confusing for new users so I'll explain about them further. 
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Live preview 
Sometimes we need to preview the result of a specifc node before connecting it to 
the main node or for debugging purposes. 


To preview anode you need to right-click on the node and select Start 
Previewing Node. 


0.165,0.485,0.795 A 
D 


Multiply a 
A Enable Realtime Preview 
B Break Link(s) 
Texture Sample A 
P Delete 
UVs © Cut 
Copy 
Duplicate 
Select Downstream Nodes 


Select Upstream Nodes 
@ View Documentation 


Add To Favorites 





Unless you enable Live Preview, you will not see any changes in the preview 
material. 


al 


You can press the spacebar to force a preview. 
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Live nodes 
This will show a real-time update of nodes due to changes made by expressions to 
that node. See the following example: 





In the preceding screenshot, the Sine node is getting a constant update from Time, 
multiplied by one. If you enable Live N odes, you will see the Sine node pulsing 
between black and white. If you change the M ultiply value from 1 to anything else 
(for example, 5) you will not see the changes unless you enable Live U pdate too. 


Live update 


When enabled, all expressions are compiled whenever you make a change, such as 
adding anew node, deleting a node, changing a property, and so on. If you have 

a complex graph, it is recommended to disable this option as it has to compile all 
nodes every time you make a change. 


Preview panel 
The Preview pane! shows the result of the Material that you are currently editing. 
You can navigate in preview Material using these options: 

Å Rotate the mesh: Drag with the left mouse button 

Å Pan: Drag with the middle mouse button 

A Zoom: Drag with the right mouse button 

Å Update light: Hold L and drag with the left mouse button 
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In the top-right corner of the preview viewport you can change some settings. This 
changes the preview mesh to the selected primitive shape: 





This changes the preview mesh to a custom mesh. You need to select a Static M esh 


in Content Browser: 


This toggles the rendering of the grid in the preview viewport: 


This toggles real-time rendering in the preview viewport: 











Details panel 


The D etails pane! shows all the properties you can edit when you select a node in 
the graph. If no nodes are selected, it will show the properties of the M aterial itself. 


For more information on these settings, please visit the M aterial properties 
documentation athttps://docs. unreal engine. com/|atest/INT/ Engi ne/ 
Rendering/Materials/ Material Properties/index. htm. 
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Graph panel 

This is the main area where you create all the nodes that decide how the Material 
Should look and behave. By default, a Material graph contains one master node that 
has a series of inputs, and this master node cannot be deleted. Some of the inputs are 
grayed out and can be enabled by changing the Blend mode in the D etails panel. 


M_Example 


©» Base Color 
©» Metallic 
©» Specular 
©» Roughness 


©» Emissive Color 


©» Normal 
© World Position Offset 


© Ambient Occlusion 





Palette panel 
The Palette panal lists all the graph nodes and Material functions that can be placed 
in the graph using drag and drop. 


al 


“ Using the Category option, you can þlter Palette contents 
between expressions or Material functions. 


Common material expressions 


There are some common Material nodes that we use most of the time when we create 
a material. To create a node you need to right-click on the graph canvas and search 
for it, or you can use the Palette window to drag and drop. Some nodes also have 
shortcut keys assigned to them. 


Let's take a look at these common nodes. 
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Constant 
Constant expression outputs a single yoat value and can be connected to almost any 
input. You can convert a constant expression to a parameter and make real-time 
changes to the M aterial instance. You can also access a parameter through Blueprint 
or C++ and see the changes in the game. 

Å Shortcut key: Hold 1 and click on the graph area 

Å Parameter shortcut key: Hold S and click on the graph area 


Å Example usage: Brighten or darken a texture 


Constant parameter is called a scalar parameter 





“Texture Sample 4 
UVs e 
~ M_Example 
@ Base Color 
© Metallic 
© Specular 
©» Roughness 


©» Emissive Color 


©» Normal 


© World Position Offset 


© Ambient Occlusion 





You can see a constant expression (0.2) being used to darken a texture. 
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Constant2Vector 


The Constant2V ector expression outputs two yoat values, which isa 

two-channel vector value (for example, red channel and green channel). 

You can convert Constant2V ector to a parameter and make real-time changes to the 
Material instance or access it in Blueprint or C++ to make dynamic changes to the 
material while playing the game. 


Å Shortcut key: Hold 2 and click on the graph area 
Å Parameter shortcut key: Hold V and click on the graph area 
Å Example usage: Adjust the UVs of a texture separately 


TexCoord ¥ | _ M_Example 


<= @ Base Color 
O Metallic 
©» Specular 
© Roughness 


© Emissive Color 


C Normal 
© World Position Offset 


© Ambient Occlusion 





You can see a Constant2V ector being used to tile a texture in the preceding 
screenshot. 
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Constant3Vector 
The Constant3V ector expression outputs three yoat values, which is a three-channel 
vector value (for example, red channel, green channel, and blue channel). You can 
convert Constant3V ector to a parameter and make real-time changes to a M aterial 
instance or access it in Blueprint or C++to make dynamic changes to a material 
while playing the game. 

Å Shortcut key: Hold 3 and click on the graph area 

Å Parameter shortcut key: Hold V and click on the graph area 


Å Example usage: Change the color of a given texture 


\ Multiply M_Example 


@® Base Color 


Texture Sample « 


Uws © 


©» Metallic 
©» Specular 
©» Roughness 


©» Emissive Color 


©» Normal 
©» World Position Offset 


© Ambient Occlusion 





You can see Constant3V ector being used to color a grayscale texture in the preceding 
screenshot. 


[45] 


Materials 


Texture coordinate (TexCoord) 


The texture coordinate expression outputs texture UV coordinates as a two-channel 
vector (for example, U and V), which helps with tiling and also allows you to use 
different UV coordinates. 


Å Shortcut key: Hold U and click on the graph area 


TexCoord A Texture Sample A "MExample 
2 UVs @ — @ BaseColor 
©» Metallic 
©» Specular 
© Roughness 


© Emissive Color 


© Normal 
© World Position Offset 


m O o- 


4 Material Expression Texture Coordinate 


Coordinate Index 


©» Ambient Occlusion 


VTiling 


Un Mirror U 


E 
E 


Un Mirror V 





The preceding screenshot shows a texture coordinate being used to tile a texture. You 
can see the values used by looking at the D etails panel in the bottom left corner. 


Multiply 


This expression multiplies the given inputs and outputs the result: 


A Multiplication happens per channel. For example, if you multiply two 
vectors (0.2, 0.3, 0.4) and (0.5, 0.6, 0.7), the actual process is the following: 


0.2 X Used = 0.4 
0.3 x 0.6 = 0.18 
0.4 x 0.7 = Delt 
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So the output is as follows: 
(0.1, 0.18, 0.28) 


Å TheMultiply node expects inputs to be the same type unless one of 
them is constant. In short, you cannot multiply Constant2V ector and 
Constant3V ector, but you can multiply Constant2V ector or Constant3V ector 
by a constant expression. 


° Shortcut key: Hold M and click on the graph area 


' M_Example 
O» Base Color 
Texture Sample A ©» Metallic 


` Multiply(,3) Y 
UVs © Sa i © Specular 


. A ® 
ian ©» Roughness 
@ Emissive Color 


©» Normal 


©» World Position Offset 





The preceding screenshot shows a multiply node being used to boost an 
emissive effect. 


Add 


This expression adds the given inputs and outputs the result: 


Addition happens per channel. For example, if you add two vectors (1, 0, 0) and (0, 1, 
0), the actual process is the following: 


0 = 1 
l=] 
0 = 0 
So the output is as follows: 


(1, 1, 0) 
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The Add node expects inputs to be the same type unless one of them is constant. 
In short, you cannot add Constant2V ector and Constant3V ector, but you can add 
Constant2V ector or Constant3V ector to a constant expression. Let's take a look 
at why it is like this. See the following screenshot: 


“add Y M_Test 
A ee) Base Color 


©» Metallic 


B 
Ecce ERROR! ©» Specular 


©» Roughness 


©» Emissive Color 


i PESE eee pe far ecko +) ESR arte a nee m sats | ee os e a ee ry * 
(Node Add) Arithmetic between type iata and flo i 





Here wearetrying to add Constant3V ector and Constant2V ector but it will not 
work. This is because, when the Material editor tries to compilethe Add node, 
it fails since the last element of Constant3V ector has nothing to add to. It will be 
like the following calculation: 


l +2 = 3 
l +2=3 
l +? = fail 


But you can add Constant3V ector to a constant expression, as in the following þgure: 


M_Test 
@ Base Color 
© Metallic 


©» Specular 


© Roughness 
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The result will be as follows: 


1 +2 = 3 
l +2 = 3 
l +2 = 3 


And that will compile pne. 


Å Shortcut key: Hold A and click on the graph area 


M_Example 
@ Base Color 
O» Metallic 


©» Specular 


©» Roughness 


©» Emissive Color 


©» Normal 
© World Position Offset 


© Ambient Occlusion 





Divide 
The divide expression divides the given inputs and outputs the result: 


Division happens by channel. For example, if you divide two vectors (0.2, 0.3, 0.4) 
and (0.5, 0.6, 0.7), the actual process is like this: 


So the output is as follows: 


(Oem, U0; US] 
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The Divide node expects inputs to be the same type unless one of them is constant. 
In short, you cannot divide Constant2V ector by Constant3V ector, but you can divide 
Constant2V ector or Constant3V ector by a constant expression. 


Å Shortcut key: Hold D and click in the graph area 


 M_Exa mple 


@ Base Color 
C» Metallic 
© Specular 
©» Roughness 


C» Emissive Color 





Subtract 


This expression subtracts the given inputs and outputs the result: 


Subtraction happens by channel. For example, if you subtract two vectors (0.2, 0.3, 
0.4) and (0.5, 0.6, 0.7), the actual process is the following: 


sa DD WI 
l 

1 1 1 

a o & 

WwW W WwW 


So the output is as follows: 


(-0.3, -0.3, -0.3) 
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The Subtract node expects inputs to be the same type unless one of them is constant. 
In short, you cannot subtract Constant2V ector from Constant3V ector, but you can 
subtract Constant2V ector or Constant3V ector from a constant expression. 


Å Shortcut key: No shortcut key 


@ Base Color 
Cy Metallic 


©» Specular 


©» Roughness 


Cy» Emissive Color 


Cy Normal 
CO» World Position Offset 


©» Ambient Occlusion 





Texture sample (Texture2D) 


Texture sample outputs the given texture. It also outputs all four channels (namely, 
red, green, blue, and alpha) from the texture separately so you can use them for 
various things. This is especially useful if you work on multiple grayscale textures 
(Such as mask textures, roughness textures, and so on). Instead of importing multiple 
textures, you can just create one texture in Photoshop and assign other textures to 
different channels and, in Material editor, you can get each channel and do all the 
fancy things. Oh, and did | mention Texture2D can use movie textures too? 


—— — [51] 
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You can convert Texture Sample to TextureSampleParameter2D and change 
textures in real-time via M aterial instance. You can also change textures dynamically 
in the game through Blueprints or C+. 

Å Shortcut key: Hold T and click in the graph area 

Å Parameter shortcut key: No shortcut key 


Texture Sample à - M_Example 


Uvs Eo - @ Base Color 
C» Metallic 
©» Specular 
©» Roughness 


C» Emissive Color 


C» Normal 
C» World Position Offset 


©» Ambient Occlusion 
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Component mask 

The component mask expression can extract different channels from the input, 

which should bea vector channe such as Constant2V ector, C onstant3V ector, 
Constant4V ector, TextureSample, and so on. For example, you know Constant4V ector 
has only one output, which is RGBA. So, if you want the green channel from RGBA, 
you use a component mask. You can right-click on a component M ask and convert it 
into a Parameter and make real-time changes in Material instance. 


Å Shortcut key: No shortcut key 
Å Parameter shortcut key: No shortcut key 


Mask(RGB) Y ~ M_Example 


eo —— @ BaseColor 
/Constant4Vector j C» Metallic 
ata tee ©» Specular 
©» Roughness 
Cy» Emissive Color 


@ Opacity 


C» Normal 
Cy» World Position Offset 


Cy» Ambient Occlusion 


Cy» Refraction 





In this screenshot, we extract the alpha channel and plug it into O pacity and plug 
the RGB channel into Base Color. 
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Linear interpolate (lerp) 


This blends two textures or values based on alpha. When the alpha value is 0 
(black color), A input is used. If the alpha value is 1 (white color), B input is used. 
Most of the time, this is used to blend two textures based on a mask texture. 


Å Shortcut key: Hold L and click in the graph area 


Å Example usage: Blend two textures based on the alpha value, which can 
be a constant or a mask texture 


Texture Sample A 


UVs | 


 M_Example 
@® Base Color 
© Metallic 


© Specular 


Texture Sample á 


© Roughness 
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Here, the lerp node is outputting 100% of input A because the alpha value is 0. If we 
set the alpha value to 1 then we'll see 100% of B. If alpha is 0.5 then we'll see a blend 
of both A and B. 
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Power 


The Power node multiplies the base input by itself with Exp times. For example, 
if you have 4 in Base and 6 in Exp then the actual process is like this: 


4x 4x 4x 4, 4x 4 = 4096 
So the result of Power is 4096. 


If you apply a Texture to Base input and havea constant value (for example, 4) 
then the Texture is multiplied four times. 


Å Shortcut key: Hold E and click in the graph area 


Å Example usage: Adjust the contrast of the height map or ambient 
occlusion map 


Crane 
Cy Base Color 
Oy Metallic 
©» Specular 
©» Roughness 


C» Emissive Color 


©» Normal 
Cy World Position Offset 


Texture Sample & 


@® Ambient Occlusion 





The preceding image shows a Power node being used to boost the contrast of a 
Texture Sample. 
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PixelDepth 


PixelD epth outputs the distance to the camera of the pixel currently being rendered. 
This can be useful to alter the appearance of the material based on the distance from 


the player. 


Å Shortcut key: No shortcut key 


Å Example usage: Change the color of an object based on the distance 
from the player 


i M_Example 
C» Base Color 
Oy Metallic 


©» Specular 


PixelDe pth as "Divide (4096) Y 


©» Roughness 
5 t — E Color 
B 


©» Normal 
©» World Position Offset 


©» Ambient Occlusion 
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If you apply the previous material to a mesh, then the color of the mesh will be 
changed based on the distance to the player camera. 


AL sa Viewporn | 
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Level: Untitled (Persistent) 
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The preceding screenshot shows how the mesh will look closer to the player camera. 
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The preceding screenshot shows how the mesh will look when it's farther away from 
the player camera. 
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Desaturation 


As the title says, the D esaturation expression desaturates its input. Simply put, it can 
convert a color image to grayscale based on a certain percentage. 


Å Shortcut key: No shortcut key 


Texture Sample & n 
M_Example 


UVs ae oe ee ee ee eee 
act Desaturation @ Base Color 
x © C» Metallic 
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Time 
This expression outputs the Time passage of the game (in seconds). This is used if 
you want your Material to change over time. 

Å Shortcut key: No shortcut key 

Å Example usage: Create a pulsing Material 


Multiply Y Sine Y ConstantBiasScale Y  M_Test 


e — eo e — eo e @ Base Color 
C» Metallic 
©» Specular 
©» Roughness 


C» Emissive Color 


C Normal 
C» World Position Offset 


O Ambient Occlusion 


©» Pixel Depth Offset 





In the previous material, we multiply Time by a constant expression. The 

result of the M ultiply node is plugged into the Sine node, which outputs a 
continuous oscillating waveform that outputs the value in a range of -1 to 1. We 
then use a ConstantBiasScale node to prevent the value from going below 0. A 
ConstantBiasScale node is basically a node that adds a bias value to the input and 
multiplies it by a scale value. By default, bias is set to 0.5 and scale to 1. So if the 
Sine value is-1, then theresultis(-1 + 1) * 0.5, which equals 0. 
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Fresnel creates rim lighting, which means it will highlight the edges of the mesh. 


Å Shortcut key: No shortcut key 


Alpha 


Fresnel 
Exponentin 
BaseReflectFractionin 


Normal 


The result of the previous network Is as follows: 
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Material types 


Now that you know some of the basic expressions, let's take a look at different 
Material types. First of all, obviously, is the main Material editor, but then you 
also have Material instances, Material functions, and layered Materials. 


Material instances 


Material instance is used to change the appearance of a Material without recompiling 
it. When you change any value in Material editor and apply it, it will recompile the 
whole shader and create a set of shaders. When you create a Material instance from 
that M aterial, it will use the same set of shaders so you can change the values in real 
time without recompiling anything. But when you use Static Switch Parameter or 
Component M ask Parameter in your Parent M aterial, then it's different because 
each of those parameters has unique combinations. For example, let's say you have 
M aterial_1 with no Static Switch Parameter, and Material_ 2 with Static Switch 
Parameter called bEnableSwitch. M aterial_ 1 will create only one set of shaders, 
while M atertal_ 2 will create two sets of shaders with bEnableSwitch = False and 
bEnableSwitch = True. 


An example workyow is to create a master Material that contains all the necessary 
parameters and let the designers make different versions. 


There are two types of Material instances. They are: 


Å Material Instance Constant 
Å Material Instance Dynamic 


Only Material Instance Constant has a user interface. M aterial Instance Dynamic has 
no user interface and cannot be created in content browser. 


Material Instance Constant 


As thetitle says, M aterial Instant Constant (MIC) is only editable in the editor. 
That means you cannot change the values at runtime. MIC exposes all parameters 
you created in the parent M aterial. You can create your own groups and organize 
all your parameters nicely. 
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Material Instance User Interface 


Å Toolbar (1): The following are toolbar options: 


° — Save: Saves the asset 

° Find in CB: Navigates to this asset in Content Browser and selects it 
° Params: Exposes all parameters from Parent M aterial 

° Mobile Stats: Toggles Material stats for Mobile 


D etails (2): Displays all the parameters from parent Material and other 
properties of Material instance. Here you can also assign a physics Material 
and override the base properties of the parent M aterial, such as blend mode, 
two-sided, and so on. 


Instance parents (3): Here you will see a chain of parents all the way up 
to the main master M aterial. The instance currently being edited is shown 
in bold. 


Viewport (4): The viewport displays the material on a mesh so you can 
see your changes in real time. You can change the preview shape in 
the top-right corner. This is the same as it was in M aterial editor. 
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Material Instance Constant example 


In order for Material instance to work, we need a master Material with parameters. 
Let's create a simple M aterial that will change its color based on the distance to 

the player, that is, when the player is near the mesh it will have a red color, and as 
they move further away it will change its color. N ote that there are 21 parameter 
expressions in UE4. 


Right now we will stick with two common parameters, and they are as follows: 


Å Scalar parameter 
Å Vector parameter 


M_Example 
©» Base Color 
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©» Specular 
© Roughness 
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As you can seein the previous screenshot, we created two vector parameters 
(Color1, Color2) and two scalar parameters (TransitionD istance, Speed). We will 
use these parameters to modify in real time. To create an Instance of this M aterial 
you need to right-click on this Material in Content Browser and select Create 

M aterial Instance. This will create a new instance M aterial right next to this M aterial. 


If you open that instance you will see all these parameters there, and you can edit 
them in real time without having to wait for the M aterial to recompile: 


U E 


a General 


Te 
M Escenas 
M_Example_inst 
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To change values in Material instance, you need to override them prst. You need 
to click the checkbox near the parameter to override the values. As shown in the 
following screenshot: 
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Material functions 


M aterial functions are graphs that contain a set of nodes that can be used across any 
number of Materials. If you often pnd yourself creating complex networks then it's 
better to make a Material function so you can contain all these complex networks in 
one single node. One thing to keep in mind is that M aterial function cannot contain 
any parameter nodes (for example, Scalar Parameter, V ector Parameter, Texture 
Parameter, and so on). To pass data into a Material function, you need to usea 
special FunctionInput node. Similarly, if you want data out of a Material function, 
you need to use the FunctionO utput node. By default, Material function creates one 
output for you but you can create more outputs If you want. 


The UI of Material function is almost the same as of Material editor. If you check 
the Details panel you will see some options to help you get the most out of your 
Material function. Let's take a look at these options: 


Å Description: This appears as a tooltip when you hover the mouse on this 
function node in Material graph. 


Å Expose to Library: Enable this to show your Material function when you 
right-click inside your Material graph. 


Å Library Categories: This list the categories this function belongs to. By 
default, it belongs to the M isc category but you can change it and add as 
many categories as you want. 


Q M aterial functions cannot be applied surface, so if you want to use a 


M aterial function you must use it in a Material. 


Material function example 


To create a Material function, prst right-click in Content Browser and go to 

M aterials & Textures and select M aterial Function. In this example, we will create 
a Material function called Normal M ap Adjuster that can boost the intensity of a 
normal map. Let's see what we need to create such a function: 


Å Texture [INPUT]: Obviously we need to pass a texture that needs to be 
modified. 


Å Intensity [INPUT]: We also need to pass how intense the normal should be. 
A value of 0 means no changes to the normal map and a value of 1 means a 
boosted normal effect. 


Å Result [OUTPUT]: Finally we will output the result, which we can connect to 
the normal channel in our Material. 
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A The pnal output node (result) can be renamed with any 
custom name you want. Select the node and, in the D etails 
panel, change O utput N ame. 


Open your M aterial function and right-click on the graph and search for Input. 


a Functions 





Select the FunctionInput node. You will see some properties in the D etails panel for 
the Input node you just selected. 


4 Material Expression Function Input 





@ Details 


Input Normal Texture (Vector3) à 


Input Name | Normal Texture a 


Preview Ci 


Description Takes a Texture 2D node a 
Input Type Function Input Vector 4w 


Use Preview Value 1E 


Let's take a look at these settings: 


A 


D> > > D> 


Input Name: A custom name for the input. You can name it whatever you 
want. Here, | called it Normal Texture. 


Description: Will be used as a tooltip when you hover over this input in 
Material graph. 


Input Type: Defines the type of input for this node. 


Preview Value: Value to use if this input is not connected in Material graph. 
Only used if Use Preview Value as D efault is checked. 


Use Preview Value as D efault: If checked, it will use the Preview Value and 
will mark this input as optional. So when you use this function, you can leave 
this input unconnected. But if you disable this option, then you must connect 
the required node to this when in Material graph. 


Sort Priority: Arranges this input in relation to other input nodes. 
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Let's create a simple network to boost the normal effect. Take a look at the following 
screenshot: 


“Input Normal Texture (Vector3) A "Mask (R opr 
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H ere we are extracting the red, green, and blue channels separately. The reason 
behind this is simply that we need to multiply Intensity (scalar input value) by only 
the blue channa to increase the normal effect. The Intensity needs to be clamped 
between 0 and 1 and then inverted using the 1-x (OneM inus) node because, when 
we use this Material function in a Material, we need 0 to have the default normal 
intensity and 1 to really boost the effect. Without the OneM inus node it will be the 
opposite, that is, 0 will boost the normal map effect and 1 will have a regular effect. 


Now that the function is done, click the Save button on the toolbar. 


Saving automatically compiles the M aterial. 
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Now to get this into Material, right-click inside the M aterial graph and search for 
N ormalM apA djuster. Then all you have to do is plug aNormal map and a Scalar 
Parameter to NormalM apAdjuster and connect it to the Normal channel. 


If it doesn't show up in the context menu, make sure you enabled 
Expose to Library in Material Function. 





“Texture S: | Roughness 
Texture Sample à © Roughness 


Cy Emissive Color 
UVs ®: 


” NormalMapAdjuster 
= 1 i Ars m - 
@ Normal Texture (V3) Result @ —_ @ Normal 


eS A 
Se miens © World Position Offset 


P Normalintensity -d 





In your M aterial instance you can adjust N ormallntensity in real time. 


Layered Material 


Layered Materials are basically M aterials within M aterials and exist as an extension 

of Material function. The basic workyow is as follows: you create a M ake M aterial 
Attribute (which features all the material attributes, such as Base Color, M etallic, 
Specular, Roughness, and so on) and you connect your nodes to it. Then you connect 
the output of M ake M aterial Attributes to the input of the O utput Result node. 


Layered Materials are most benepcial when your assets have different layers of 
materials. For example, think about a character with different elements such as 
metallic armor, leather gloves, skin, and so on. Depning each of these materials and 
blending them in a conventional way will make the material complexity increase 
signipcantly. If you use layered Material in such cases, you can depne each of those 
materials as a single node and blend them very easily. 
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Creating layered Material using make material attributes 
For this example we will create two simple layered Materials and blend them 
together in our þnal material. First, create a M aterial function and open it. In 
Material function, follow these steps: 


1. 


4. 


5. 


Right-click on the graph editor and search for M ake M aterial Attributes 


and select the node from that menu. 


Create a Constant3V ector node and connect it to BaseC olor of M ake 


M aterial Attributes. 


Create a constant value and connect it to M etallic of M ake M aterial 


Attributes. 


Create one more constant value and connect that to Roughness of M ake 


M aterial Attributes. 


Finally, connect M ake M aterial Attributes to the output of M aterial function. 


The þnal Material function should look like this. N ote the values I'm using for 
constant nodes. 


0.131,0.517,0.765 A 
D 


"MakeMaterialAttributes Y 


e Slated at fed mot oe 
Output Blue 

A 

e © 


@ BaseColor 
@ Metallic 


©» Specular 


- @ Roughness 


©» EmissiveColor 

© Opacity 

© OpacityMask 

©» Normal 

©» WorldPositionOffset 
© WorldDisplacement 
© TessellationMultiplier 
©» SubsurfaceColor 

© ClearCoat 

©» ClearCoatRoughness 
© AmbientOcclusion 
© Refraction 

©» CustomizedUVs0 

©» CustomizedUVs1 

©» CustomizedUVs2 

©» CustomizedUVs3 

©» CustomizedUVs4 

© CustomizedUVs5 

©» CustomizedUVs6 


© CustomizedUVs7 
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Since we want this to be M etallic, we set M etallic to 1. 


We will create a duplicate of this same M aterial function and make it a non-metallic 
Material with a different color. See the following image: 


TT" 


0.765,0.118,0.0668 A 


B 
ENE  MakeMaterialAttributes Y 
@ BaseColor ® 


@ Metallic 

©» Specular 

@ Roughness 
O EmissiveColor 
©» Opacity 

©» OpacityMask 


Output Red 
A 


©» Normal 

©» WorldPositionOffset 
© WorldDisplacement . oO 
©» TessellationMultiplier 

©» SubsurfaceColor 

© ClearCoat 


©» ClearCoatRoughness 


© AmbientOcclusion 
©» Refraction 

©» CustomizedUVs0 

©» CustomizedUVs1 

©» CustomizedUVs2 

©» CustomizedUVs3 

©» CustomizedUVs4 
©» CustomizedUVs5 

©» CustomizedUVs6 


©» CustomizedUVs7 





This is a non-metallic M aterial and we are going to blend these two Materials in our 
M aterial editor using a default M aterial Layer Blend function. 


[72] 


Chapter 3 


Make sure you expose both of these M aterial functions so we can use them in 
Material editor. 


Open an existing Material or create a new one in Content Browser and open it: 


1. 


Right-click on the graph and search for your Material functions (Select both 
of them). 


Right-click again on the graph and search and select M atLayerBlend_ 
Simple. 

Connect your Material functions to M atLayerBlend_ Simple. Connect one 
function to Base M aterial and the other one to Top M aterial. 


N ow, to blend these two materials we need an Alpha (Scalar) value. A value 
of 1 (white) will output Base M aterial and a value of 0 will output Top 
M aterial. A value of 0.5 will output a mix of both Base and Top materials. 


Since we are using layered Material we cannot directly connect this to the M aterial 
editor like other nodes. To make this work, there are two ways wecan connect. 


M ethod 1: 

Wecan make the material use M aterial attributes instead of regular nodes. 

To use this feature, click anywhere on the graph and in the Details pane! select 
Use M aterial Attributes: 


1) Details 
Search 
> Physical Material 
4 Material 
Material Domain 
Blend Mode 
Decal Blend Mode 


Decal Response 


shading Model Default Lit ¥ 


Opacity Mask Clip Value 


Two Sided 
Tangent Space Normal 


Use Material Attributes 


Subs urfac 





Materials 


When you enable this, the main material node will show only one node called 
M aterial attributes so you can connect the output of M atLayerBlend_ Simple 
to this node. 


The following is a screenshot of the pnal material using this method: 





M ethod 2: 
In this method, instead of using Material attributes for the main node we use 
BreakM aterialA ttributes and connect them as regular nodes: 
1. Right-click on the graph area and search and select BreakM aterialA ttri butes. 
2. Connect the output of M atLayerBlend_ Simple to BreakM aterialA ttributes. 


3. And pnally, connect all the output nodes of BreakM aterialA ttributes to the 
main node of Material editor. 
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The following is a screenshot of the þnal material using this method: 


LayeredMaterial_Function_1 p 


Blue @ 


“MatLayerBlend_Simple _ a BreakMaterialAttributes V LayeredMatrial_Example 
Base Material (MA) Blended Material @ ———— @ attr BaseColor @ @ Base Color 
—————— Top Material (MA) Metallic @ @ Metallic 
LayeredMaterial_Function_2 
Alpha (S) Specular O © Specular 


Red @ 
Roughness @ ———— @ Roughness 


Texture Sample A EmissiveColor © © Emissive Color 


UE © Opacity O 
OpacityMask O 
Normal O» © Normal 

WorldPositionOffset O» © World Position Offset 
WorldDisplacement ©» 
TessellationMultiplier O 
SubsurfaceColor O» 
ClearCoat O 
ClearCoatRoughness © 

AmbientOcclusion ©» ©» Ambient Occlusion 

Refraction © 
CustomizedUVO O» 
CustomizedUV1 © 
CustomizedUV2 O» 
CustomizedUV3 ©» 
CustomizedUV4 O» 
CustomizedUV5 ©» 
CustomizedUV6 © 
CustomizedUV7 ©» 





Summary 


In the next chapter we will use post processing techniques to enhance the look of 
your scene. We will also create a simple Material and use it in post process M aterial. 
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Post Process 


Post Process in Unreal Engine 4 allows you to create a variety of artistic effects and 
change the overall look and feel of the whole game. Post Process effects are activated 
using Post Process Volumes and can be used individually to affect only a specipc 
area or the entire scene. You can have multiple Post Process Volumes overlapping 
and render their effects based on their priority. Post Process Volumes can be used to 
add or modify simple effects such as Bloom, Lens Flares, Eye Adaptation, Depth of 
Field, and so on and they can also be used to get advanced effects using Materials. 
Another great feature of Post Process Volume is Look up Table (LUT), which is 
used to store color transformations from image editing software, such as Adobe 
Photoshop or GIMP. They are very easy to set up and can yield very good results. 
We will get into LUT later in this chapter. 


When you prst start a project without starter content, there will be no Post Process 
Volumes present in the scene, so Engine will use the default settings. You can change 
these settings per project under Project Settings: 

1. Click on Edit in the menu bar. 

2. Click on Project Settings. 

3. Goto the Rendering section. 
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4. Expand Default Postprocessing Settings: 


Edit § Window Help Á ae Sy 
ist Prgjses Saiit 
*) Undo Clicking on Actors 


Engine - Rendering 


*§) Undo History 


Cut f bs These settings are saved in DefaultEngine.ini, which is currently writable 


Copy 


Duplicate : 
Delete Tar 4 Postprocessing 
onfigurat A Separate Translucency 
Editor Preferences Custom Depth Pass 
Sys 
> 4 Translucency 
Translucent Sort Policy Sort by Distance w 
b Translucent Sort Axis S ES S 


4 Default Postprocessing Settings 
Bloom 
Ambient Occlusion 
Ambient Occlusion Static Fraction (AO for baked lightin 
Auto Exposure 
Motion Blur 


Lens Flares (Image based) 


i 


Anti-Aliasing Method emporalAA ¥ 


4 Optimizations 


Early Z-pass Decide automatically ~ 


Movables in early Z-pass a 


Clear Scene Hardware clear Žž w 





Here, you will see the default settings for Unreal Engine when there is no Post 
Process Volume in your scene. You can modify these settings or add a Post Process 
Volume to override them independently. 


Adding Post Process 


To use Post Process, you need a Post Process Volume in your scene: 


1. Goto the M odes tab (if you closed it, press Shift +1). 
2. Select the Volumes tab. 
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3. Drag and drop Post Process Volume into the scene: 


fF Modes 


Search Classes 
Recently Placed 
Basic 

Lights 

Visual Effects 
BSP 

Volumes 


All Classes 


Blocking Volume 


Camera Blocking Volume 


Cull Distance Volume 


Kill ZVolume 


Level Streaming Volume 


Lightmass Character Indirect Det 


Lightmass Importance Volume 


Nav Mesh Bounds Volume 


Nav Modifier Volume 


Pain Causing Volume 


Physics Volume 


Post Process Volume 


Precomputed Visibility Override V 


Precomputed Visibility Volume 


«(Bae 
Trigger Volume 
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Post Process 


You now havea Post Process Volume in your scene. However, it only shows the 
effects when the player is inside that volume. To make it affect the whole scene 
perform the following steps: 


1. 
2. 


3. 


Select Post Process V olume 


In the D etails panel, scroll down and expand the Post Process V olume 
section 


Enable Unbound 


Enabling Unbound will ignore the bounds of this volume and affect the whole scene. 
N ow, let's take a quick look at these Post Process settings: 


4 Post Process Volume 
Priority 


Blend Radius 


Blend Weight 


Enabled 


Unbound 





Priority: If multiple volumes are overlapping each other, then the volume 
with higher priority overrides the lower one. 


Blend Radius: This is the radius of the volume used for blending. Generally, 
avalueof 100 works best. This setting is ignored if you have U nbound 
enabled. 


Blend Weight: This defines the influence of properties. 0 means no effect and 
1 means full effect. 


Enabled: This enables or disables this volume. 


Unbound: If enabled, then Post Process effects will ignore the bounds of this 
volume and will affect the whole scene. 
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LUT 


LUTs are color neutral textures unwrapped to a 256 x 16 size texture. They are used 
to create unique artistic effects and are modibed using image editing software such as 
Adobe Photoshop. If you are not familiar with Photoshop, you can use free and open 
source software such as GIMP. The following is an image of the default LUT texture: 





The procedure of LUT ts as follows: 


1. First you take a screenshot of your world and bring it into Photoshop. 
2. On top of that screenshot, you insert the LUT texture. 


3. Then ontop of both, apply color manipulations (for example: 
adjustment layer). 


4. Now select the LUT texture and save it with your color manipulation as 
PNG or TGA. 


5. Finally, import your LUT into Unreal Engine. 


N ote that after you import your LUT into Content Browser, 
open it and set the Texture Group to ColorLookupTable. 
~  Thisis an important step and should not be skipped. 


To apply the LUT, select the Post Process volume, and under the Scene Color 
section, you can enable Color Grading and set your LUT texture: 


Ej Color Grading | i) LUT _Merning cai S a 9 


With the Color G rading Intensity option, you can change the intensity of the effect. 
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Post Process Materials 


Post Process Materials help you create custom post processing with the help of 
Material Editor. You need to create a Material with your desired effect and assign it 
to Blendables in Post Process Volume. Click on the plus sign to add more slots: 


4 Mise 


ad Blendables 





Before | explain about Post Process Materials, let's take a quick look at one of the 
most important Post Process nodes in Material Editor: 


Å Scene Texture: This node has multiple selections that output different 
textures: 


4 UMaterial Expression Scene Texture SceneTexture:PostProcessinputO w 


Scene Texture Id PostProcessinput0+ i 
Ce gl or LI 5 C 0 | OF Ci 


Size O 


InvSize Or 


Clamp UVs 
Filtered 
4 Material Expression 


Desc 


D N MeL 
Ambient Occlusion 





[82] 


Chapter 4 


Å UVs (optional): This input tiles the texture. For UV operations on the 
SceneT exture node, it is good to use the ScreenPosition node instead 
of the regular Texture Coordinate node. 


Å Color: This outputs the final texture as RGBA. If you want to multiply this 
with acolor, you first need to use a component mask to extract R, G, and B 
and then multiply it by your color. 


Å Size: This outputs the size (width and height) of the texture. 
Å InvSize: This is the inverse of the Size output. (1/ width and 1/ height). 


__ Itis important to keep in mind that you should only use Post Process 
Materials when you really need them. For Color Correction and 
J Various other effects, you should stick with the settings from Post 
Process Volume since they are more efficient and optimized. 


Creating a Post Process Material 
With Post Process M aterial, you can create your own custom Post Processing effects. 
Some examples are: 
Å Highlighting a specific object in your game 
Å Rendering occluded objects 
A Edge detection, and so on 
In this quick example, we will see how to highlight an object in our world. To render 


a speciþc object separately, we need to put them to a custom depth buffer. The good 
thing is, it's as easy as clicking on a checkbox. 
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Select your Static Mesh and under the Rendering section, expand the options and 
enable Render Custom D epth: 


4 Rendering 
Visible 
Actor Hidden In Ga E 


4 TextureStreaming 
Ignore Instance 1 fj 
streaming Distar 
Force Mip Strear 

a LOD 
Forced Lod Mode Oa 
Min Draw Distam O00 ad] 
Desired Max Dray OO o 
Current Max Drai 
Allow Cull Distan 


Detail Mode Low ¥ 


> Override Materials lelements -—* gj 


> E m 


Render Custom De 


Render in Main Pas 
Receives Decals 
Owner No See 


Only Owner See | I 





Treat as Backgrouy W 


Now that the mesh is rendered in theCust omDept h buffer, we can usethis 
information in Material Editor to mask out and render it separately. To do that: 


1. 
2. 


Create a new Material and open it. 


First thing to do now is to set M aterial Domain to Post Process. This will 
disable all inputs except Emissive Color. 


N ow, right-click on the graph and search for SceneT exture and select it. Set 
Scene Texture Id to CustomD epth. 


CustomD epth outputs a raw value so let's divide it by the distance we want. 
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5. Add anew Divide node and connect CustomD epth to input A . Select the 
divide node and for Const B givea high value (for example: 100000000). 
Remember, 1 Unreal Unit is equal to1 cm so if you give a small value like 
100 or 1000, you need to go really close to the object to see the effect. This is 
why weusea very large value. 


6. Add a Clamp node and connect Divide to the prst input of the Clamp node. 


7. Create aLerp node and connect the output of Clamp to theA lpha input of 
Lerp. TheLerp node will blend inputA and B based on the alpha value. If the 
alpha valueis1, then inputA is used. If itis0 then input B is used. 


8. Create another SceneT exture node and set its Scene Texture ld to 
PostProcess!I nput0. PostProcessI nput0 outputs the pnal HDR color so make 
sure you use this. There's another output called SceneC olor, which does the 
same but it outputs lower quality of the current scene. 


9. Right-click on the graph again and search for the D esaturation node. 
Connect PostProcessI nput0 Color output to D esaturation input. We will use 
this to desaturate the whole scene except our mesh with CustomD epth. 


10. Connect the D esaturation output to Lerp B and PostProcessI nput0 to 
Lerp A, and Pnally, connect the Lerp to Emissive Color. 


Here is the pnal screenshot of the whole graph: 
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And in this example scene, I've applied this Material to Post Process Blendables and 
you can see the effect: 


(=) s> Perspective || & Lit || Show 


Level: Untitled(Persistent) 





Everything that is in color has Render Custom Depth enabled so the Post Process 
M aterial is masking them out and applying the desaturation to the entire scene. 


Summary 


In next chapter, we will add lights and discuss Light M obility, Lightmass, and 
Dynamic Lights. 
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Lighting is an important factor in your game, which can be easily overlooked, 
and wrong usage can severely impact on performance. But with proper settings, 
combined with post process, you can create very beautiful and realistic scenes. 


In this chapter, we will look into different light mobilities and learn more about 
Lightmass Global Illumination, which is the static Global Illumination solver 
created by Epic games. We will also learn how to prepare assets to be used with it. 


Lighting basics 
In this section, we will see how to place lights and how to adjust some 
important values. 
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Placing lights 
In Unreal Engine 4, lights can be placed in two different ways. Through the modes 
tab or by right-clicking in the level: 


ey Modes tab: In the M odes tab, go to the place tab (Shift +1) and go to the 
Lights section. From there you can drag and drop various lights. 


‘ir Modes 
— i” f AS a F E] q 
s A A i Ņ 


Recently Placed 


a Directional Light 


Basic 


Lights Point Light 


Visual Effects 
Spot Light 

BSP 

Volumes £62) Sky Light 


All Classes 





eV Right-clicking: Right-click in viewport and in Place Actor you can select 
your light. 


Select 

Edit p 
visibility b Lights 
Level aa... 
oe Directional Light 


Replace Selected Actors with » 2 Spot Light 


Attach To b 
* Point Light 
p 





Transform 
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Once alight is added to the level, you can use the transform tool (W to move, E to 
rotate) to change the position and rotation of your selected light. 


Y Since Directional Light casts light from an inþnite source, 
updating their location has no effect. 


Various lights 
Unreal Engine 4 features four different types of light Actors. They are: 


ey Directional Light: Simulates light from a source that is infinitely far 
away. Since all shadows cast by this light will be parallel, this is the 
ideal choice for simulating sunlight. 


eV Spot Light: Emits light from a single point in a cone shape. There are two 
cones (inner cone and outer cone). Within the inner cone, light achieves 
full brightness and between the inner and outer cone a falloff takes place, 
which softens the illumination. That means after the inner cone, light 
slowly loses its illumination as it goes to the outer cone. 


ey Point Light: Emits light from a single point to all directions, much like 
a real-world light bulb. 


eV Sky Light: Does not really emit light, but instead captures the distant 
parts of your scene (for example, Actors that are placed beyond Sky 
Distance Threshold) and applies them as light. That means you can have 
lights coming from your atmosphere, distant mountains, and so on. Note 
that Sky Light will only update when you rebuild your lighting or by 
pressing Recapture Scene (in the Details panel with Sky Light selected). 


Common light settings 


Now that we know how to place lights into a scene, let's take a look at some of the 
common settings of a light. Select your light in a scene and in the D etails panel you 
will see these settings: 


ey Intensity: Determines the intensity (energy) of the light. This is in lumens 
so, for example, 1700 Im corresponds to a 100 W bulb. 


ey Light Color: Determines the color of the light. 
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ey Attenuation Radius: Sets the limit of the light. It also calculates the falloff 
of the light. This setting is only available in Point Lights and Spot Lights. 





Attenuation Radius from left to right: 100, 200, 500. 


eV Source Radius: Defines the size of specular highlights on surfaces. 
This effect can be subdued by adjusting the Min Roughness setting. 
This also affects building light using Lightmass. A larger Source Radius 
will cast softer shadows. Since this is processed by Lightmass, it will 
only work on Lights with mobility set to Static. 
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Source Radius 5. Notice the soft edges of the shadow. 


eV Source Length: Same as Source Radius. 


Light mobility 

Light mobility is an important setting to keep in mind when placing lights in 
your level because this changes the way light works and impacts on performance. 
There are three settings that you can choose. They are as follows: 


eV Static: A completely static light that has no impact on performance. 
This type of light will not cast shadows or specular on dynamic 
objects (for example, characters, movable objects, and so on). Example 
usage: Use this light where the player will never reach, such as distant 
cityscapes, ceilings, and so on. You can literally have millions of lights 
with static mobility. 


eV Stationary: This is amix of static and dynamic lights and can change its 
color and brightness while running the game, but cannot move or rotate. 
Stationary lights can interact with dynamic objects and are used where 
the player can go. 


ey Movable: This is acompletely dynamic light and all properties can be 
changed at runtime. Movable lights are heavier on performance so use 
them sparingly. 
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Only four or fewer stationary lights are allowed to overlap each other. If you have 
more than four stationary lights overlapping each other, the light icon will change 
to red X, which indicates that the light is using dynamic shadows at a severe 


performance cost! 





In the following screenshot, you can easily see the overlapping light. 
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In View Mode, you can change to Stationary Light Overlap to see which light is 
causing an issue. 


Lightmass Global Illumination 


Lightmass is the high-quality static Global Illumination solver created by Epic 
games. Global Illumination (GI) means the process that simulates indirect lighting 
(for example, light bouncing and color bleeding from surfaces). In Unreal Engine, 
light bounces by default with Lightmass and is based on the base color of your 
material, which controls how much light should bounce from the surface of the 
object. Even though a more highly saturated color will bounce more light, and aless 
saturated color will bounce less, it all depends on the scene. In a simple room-like 
scene, this can be noticeable, whereas if it's an outdoor day scene this might not be 
that noticeable. 


Let's take a quick look at the following scene: 
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This is asimple scene in unlit mode. 





Now | added one Directional Light and this is how it looks with no Gl. 
That means there is only direct lighting and no indirect lighting (meaning there 
is no light bouncing). 
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The previous screenshot is with static GI and you can see how the whole scene came 
to life with GI. Notice how the pillars are casting shadows. These are called Indirect 
Shadows since they are from Indirect Light. 


The intensity and color of indirect light depends on the light and base color of the 
material that the light is bouncing off. To illustrate this effect, let's take a look at the 
following two screenshots: 
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Herel applied a pure red material (the red value is 1.0) to the sphere and you 
can see bounced lighting picked up the base color of the red sohere changing 
the environment. This is called color bleeding and is most noticeable with highly 
saturated colors. 





In this screenshot, | changed the value of red to 0.1 and rebuilt the lighting. And 
since red is more dark now, less light is bouncing. This is because darker colors will 
absorb the light instead of reyecting It. 


Now that we know what Lightmass Is, let's take a look at how wecan prepare our 
assets to use Lightmass and learn more about Lightmass settings. 
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Preparing your assets for precomputed 
lighting 


In order for your asset to have clean light and shadow details, it is necessary to 

have uniquely unwrapped UV to represent its own space to receive dark and light 
information. One rule of thumb when creating lightmap UVs is that the UV face 
Should never overlap with any other face within the UV space. This is because If 
they are overlapping, then after light building, the lightmap corresponding to that 
space will be applied to both faces, which will result in inaccurate lighting and 
shadow errors. Overlapping faces are good for normal texture UVs since the texture 
resolution will be higher for each face, but the same rule does not apply for lightmap 
UVs. In a 3D program, we unwrap lightmap UVs to anew channa and use that 
channel in Unreal Engine 4. 


4 Static Mesh Settings 
Double Sided Geometry E 
Simple Collision Physical Mi None 


Collision Complexity Default ¥ 


Light Map Resolution 128 


Lov Bias Multiplier 1.0 
> Walkable Slope Override 
Light Map Coordinate Index d 


Use Maximum Streaming Te E 


streaming Distance Multipli 


Asset User Data 0 elements + Ë 





z 


Here, you can sæ l'm using the second channel in my mesh for lightmap. 


Unreal starts counting from 0 while most 3d programs count from 
1. That means UV channel 1in the 3d program is UV channel Oin 
CISS Unreal, and UV channel 2 means UV channel 1in Unreal. Here, in 
| the previous screenshot, you can see the Light M ap Coordinate 
Index is 1, which means it is using the 2nd UV channel in mesh. 
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Even though you can generate lightmap UVs in Unreal Engine 4, it is highly 
recommended to create these UVs in a 3d program (for example, Autodesk M aya, 
Autodesk 3dsmax, Modo, and so on) in order to have clean lightmaps. Before 
creating alightmap UV you have to set up the grid setting in your 3d app's UV 
editor. For example, if you have an asset that requires a lightmap resolution of 128, 
then your grid setting should be ///26, which is 0.00793650. 128 will be the lightmap 
texture resolution. Higher values, such as 256, 512, 1024, and so on, will result in 
high-quality lightmaps but will also increase memory usage. Once we decide what 
lightmap resolution we need for our asset, we subtract 2 (you can also use 4) from 
that resolution. The reason behind this is that in order for Lightmass to calculate 
correctly without any þlter bleeding errors, it is recommended to havea minimum 
of 2 pixel gaps between UVs. So if your asset is going to use a lightmap resolution 
of 128, it will be 728 — 2 = 126. The reason why wedivideit by 1is that by default, 
Lightmass uses a 1 pixel border for pltering purposes. 


Once you import your mesh into Unreal Engine 4, you set the Light Map Resolution 
for your Static Mesh. This value controls how good the shadow will look when 
another object casts a shadow onto this object. 


Lightmaps are textures generated by Unreal Engine and overlayed on top of your 
scene. Since this is a texture, it should bein power of two (for example, 16, 32, 64, 
128, 256, 512, 1024, etc.). 
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The yoor in the preceding screenshot has a lightmap resolution of 32 Notice 
inaccurate shadows on the yoor. 


‘AL eric 


| =|| 2 Perspective [ge ta || stew | 





The yoor in the preceding screenshot has a lightmap resolution of 256. N otice better 
Shadows on the yoor. 


Even though increasing the lightmap resolution gives accurate 
Shadows, it is not a good idea to increase it for every mesh in your 
level as it will severely increase build times and may even crash the 
whole editor. For smaller objects, it is always a good idea to keep it 


low. 
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In Unreal Engine 4, you can generate lightmap UVs when importing your mesh by 
enabling G enerate Lightmap UVs. 


AL FBX Import Options 


Current File: /Game/EditorSphere_? 
4 Mesh 
Import as Skeletal 


Auto Generate Collision 


Static Mesh LODGroup 


Vertex Color Import Option 


Remove Degenerates 
Generate Lightmap Uvs 
One Convex Hull Per UCX 
Import Mesh LODs 
Normal Import Method 


Combine Meshes 


4 Transform 
> Import Translation 
> Import Rotation Roll nN | 
Import Uniform Scale 
i Material 
Import Materials 


Import Textures 


t Miscellaneous 


port Al 





In case you miss this option, you can still generate lightmap UVs after importing. To 
do that perform the following steps: 
Double-click on the Static M esh in Content Browser. 
2. Then, under theLOD tab, enable Generate Lightmap UVs. 


3. Select Source Lightmap Index. Most of the time this will be 0 since that 
is normal texture UVs, and Unreal generates your lightmap UVs from 
texture UVs. 
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4. Set Destination Lightmap Index. This is where Unreal will save your newly 
created lightmap UVs. Set this to 1. 
5. Click Apply Changes to generate lightmap UVs. 


Triangles: 3,968 Vertices: 2.333 
WorldGridWatenal ¥ 
Doa 


Textures + | 


Element 0 


Cast Shadow 
Enable Collision 


a Build Settings 
Recompute Normals 
Recompute Tangents 
Use MikkTSpace Tangent 
Remove Degenerates 
Use Full Precision UVs 
Generate Lightmap UVs 


Min Lightmap Resolution 


| 


source Lightmap Index 


al 


Destination Lightmap Inde 
Build Scale Aa 1.0 
Distance Field Resolution: WAN 
Generate Distance Field as ea 


Distance Field Replaceme: None 





If you already havea lightmap UV in the Destination Lightmap 
Index, it will be replaced when generating a new one. 
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You can preview UVs by clicking on the UV button in the toolbar and selecting your 
UV Channel. 
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UV Channel 0 


- V Channel 1 


LOD: 0 
Current Screen Size: 0.462569 
o 


Size: 320x320x320 
Num PAA jes: 1 


Showing UV channel 1 for LOD 0 
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Building a scene with Lightmass 


Building a scene with Lightmass is a pretty straightforward process. In order to have 
high-quality static Global Illumination (aka Precomputed Lighting), you need to 
have a Lightmass Importance V olume in your scene. This is because in many maps, 
we have areas large enough and the playable area is actually smaller. So instead of 
calculating lighting for the whole scene, which can increase light building heavily, 
we limit the area by using Lightmass I mportance V olume. 
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Once we have a Lightmass I mportance V olume in the scene and start light building, 
Lightmass will only calculate lighting within the volume. All objects outside the 
volume will only get one bounce of light with low quality. 


To enclose the playable area in Lightmass Importance V olume you just have 

to drag and drop it from the M odes tab. J ust like other objects, you can use transform 
tools (W to move, E to rotate, and R to scale) to adjust Lightmass Importance 
Volume in your scene. Once that is done, all you have to do is build the lighting 
from the Build button. 


| in- " Tra & ‘4 Ps F - — "F 


Build Compile Play Launch 


Lighting 





Alternatively, you can simply press the Build button, which will build the lighting. 
Lightmass has four different quality levels that you can choose from. They are 
Preview, Medium, High, and Production. 


. et, es i = a b = ee! 


Build Compile Play Launch 
Lighting 
Build Lighting Only 
g Quality Level 
è Production 
High 


Medium 


Lighting Info b 


{| Use Error Coloring 


| Show Lighting Stats 
Preview 





ey Preview: Can be used while developing and this results in building the 
light faster. 


ey Production: When your project is near-complete or ready to ship you 
should use the production setting since it makes the scene more realistic 
and corrects various light bleed errors. 


Q Lighting quality are just presets. There are lots of settings that 
Q should be tweaked to get the desired effect you want in your game. 
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Tweaking Lightmass settings 

Lightmass offers a lot of options in World Settings, which you can tweak to get 
the best visual quality. You can access them by clicking on Settings and selecting 
World Settings. 


w ee 
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Settings Blueprints Matinee Build Compile 
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World Settings 


Project Settings... Displays the world settings 





t | oy 
election 


In World Settings, expand Lightmass Settings and you will see various settings you 
can tweak to get the most out of Lightmass. 


4 Lightmass 
4 Lightmass Settings 
static Lighting Level Scale 


Num Indirect Lighting Bounces 
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Indirect Lighting Quality 
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indirect Lighting Smoothness 


>» Environment Color 
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Environment Intensity 

Diffuse Boost 

Use Ambient Occlusion 

Direct Illumination Occlusion Fraction 
Indirect Illumination Occlusion Fraction 


Occlusion Exponent 
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Fully Occluded Samples Fraction 


Max Occlusion Distance 


Fa 


Visualize Material Diffuse 


SSE 


Visualize Ambient Occlusion 
Volume Light Sample Placement Scale 


Compress Lightmaps 


Level Lighting Quality 
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Controlling these settings helps you get the best visual quality when using 
Lightmass. Let's take a look at these settings: 


eV Static Lighting Level: This setting calculates the detail when building 


eV 


the light. Smaller values will have more detail but greatly increase build 
time! Larger values can be used for huge levels to lower build times. 


Num Indirect Lighting Bounces: This determines how many times the 
light should bounce off surfaces. O is direct lighting only, meaning there 
will be no Global Illumination, and 1 is one bounce of indirect lighting, 
and so on. Bounce 1 contributes most to the visual quality, and successive 
bounces are nearly free but do not add very much light since bounced 
light gets weaker after each bounce. 





eV 


Num Indirect Lighting Bounces set to 1 


Indirect Lighting Quality: Higher settings result in fewer artifacts such 
as noise, splotchiness, and so on, but will also increase build time. Using 
this setting with Indirect Lighting Smoothness helps to get detailed 
indirect shadows and ambient occlusion. 
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ey Indirect Lighting Smoothness: Higher values will cause Lightmass to 
smooth out indirect lighting but will lose detailed indirect shadows. 





Indirect Lighting Quality: 4.0 and Indirect Lighting Smoothness: 0.5. Notice the difference in the 
shadow cast by the pillar 
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Environment Color: Think of this as a big sphere surrounding the level, 
emitting color in all direction. That is, this acts as the HDR environment. 


Environment Intensity: Scales the intensity of Environment Color. 


Diffuse Boost: This is an effective way of increasing the intensity of 
indirect lighting in your scene. Since indirect lighting bounces off 
surfaces, this value will boost the influence of the color. 


Use Ambient Occlusion: Enables static ambient occlusion. Since ambient 
occlusion requires dense lighting samples, it will not look good in 
Preview builds. It's better to tweak ambient occlusion settings while you 
are building using production preset. 


Direct Illumination Occlusion Fraction: How much ambient occlusion 
to be applied to direct lighting. 


Indirect Illumination Occlusion Fraction: How much ambient occlusion 
to be applied to indirect lighting. 


Occlusion Exponent: Higher values increase the ambient occlusion 
contrast. 


Fully Occluded Samples Fraction: This value determines how much 
Ambient Occlusion an object should generate on other objects. 


M ax Occlusion Distance: Maximum distance for an object to cause 
occlusion on another object. 


['329"] 


Lights 


ey Visualize M aterial Diffuse: Overrides normal direct lighting and 
Indirect lighting with the material diffuse term exported to Lightmass. 





Visualize M aterial Diffuse enabled 


ey Visualize Ambient Occlusion: Overrides normal direct lighting and 
indirect lighting with ambient occlusion. This is useful when you are 
tweaking Ambient Occlusion settings. 


['32:"] 





Visualize Ambient Occlusion enabled 


ey Volume Light Sample Placement Scale: Scales the distance at which 
volume lighting samples are placed. 


All these Lightmass settings require lighting rebuild. So if you 
change any of these settings, make sure you rebuild the lighting 
-for the changes to take effect. 


Volume Light Samples are placed by Lightmass in the level after light building, 
and are used for dynamic objects such as characters, since Lightmass only generates 
lightmaps for static objects. This ts alSo called Indirect Lighting Cache. 
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In the following screenshots, you can see how the movable object (red sphere) ts lit 
using Indirect Lighting Cache: 





With Indirect Lighting Cache 





Without Indirect Lighting Cache 
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Volume Light Samples are only placed within Lightmass 
y= Importance Volume and on static surfaces. 


Indirect Lighting Cache also helps with previewing objects with unbuilt lighting. 
After light building, if you move a static object, it will automatically use Indirect 


Lighting Cache until the next light build. 


To visualize volume lighting samples, click on Show | Visualize| Volume 
Lighting Samples. 





Volume Lighting Samples previewed in the leva. 
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You can adjust Global Illumination Intensity and Color in 
Post Process V olume. In Post Process Volume, expand Post 
Process Settings | Global Illumination and there you see 
settings for Color and Intensity. 





4 Post Process Volume 
a Post Process Settings 
> White Balance 
> Color Grading 
> Film 
> Scene Color 
> Bloom 
> Light Propagation Volume 
> Ambient Cubemap 
> Auto Exposure 
> Lens Flares 
> Ambient Occlusion 
Global Illumination 
e E 


Indirect Lighting Intensity 


b Motion Blur 


> Screen Space Reflections 


Priority 
Blend Radius 
Blend Weight 
Enabled 


Unbound 
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To toggle specibc lighting components for debugging, you can use the various 
lighting component yags under the Show | Lighting Components section. For 
example, if you want to preview your scene without any direct lighting, you can turn 
off Direct Lighting and preview your scene in Indirect Lighting only. Keep in mind 
that these are only editor features and do not affect your game. These are only for 
debugging purposes. 


Use Defaults 


Common Show flags 
Anti-aliasing 
| i BSP 
|% Collision 
| ® Decals 
Foq 
= Grid 
Landscape 
¥ Navigation 
Particles Sprite 
Skeletal Meshes 
| f7 Static Meshes 
v ™@® Translucency 
All Show flags 
Post Processing b 
Bi) Ambient Occlusion 
Lighting Features iv] Diffuse 
Developer bi) Direct Lighting 
Visualize +l Directional Lights 
Advanced b “| Dynamic Shadows 
Sitar W| Global Illumination 
Volumes +i Point Lights 


Layers b lw] Sky Lighting 


Sprites bi] Specular 





W Spot Lights 


Summary 


In this chapter, we learned about lights and how they can improve the realism of 
your scene by using Lightmass Global Illumination, and how to prepare our assets 
to use with Lightmass. We also learned about various lights and common settings. 
In the next chapter we will dive into the best and most unique feature of Unreal 
Engine 4: Blueprints. 
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Blueprints 


In this chapter, we will learn what Blueprints are and how they can be used to 
prototype your game. We will learn about: 


Å Getting familiar with Blueprint editor 


Various Blueprint graph types (for example, function graphs, event graphs, 
and so on) 


A 
Å Blueprint nodes 
A 


And, finally, we will create a simple Blueprint that can be placed in world or 
dynamically soawned while running the game 


Blueprint Visual Scripting in Unreal Engine 4 is an extremely powerful and yexible 
node-based interface to create gameplay elements and provides artists and designers 
with the ability to program their game and to quickly iterate gameplay within 

the editor without writing a single line of code! Using Blueprints you can create 

and tweak gameplay, characters, inputs, environments, and virtually anything 

in your game. 


Blueprints work by using graphs that contain various nodes connected to each other, 
which depnes what the Blueprint does. For example, it can be gameplay events, 
Spawning new Actors, or anything really. 
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Different Blueprint types 


Let's take a quick look at various Blueprint types that are available in Unreal 
Engine 4: 


Å Level Blueprint: Level Blueprint is a special Blueprint that acts as a 
level-wide global event graph, which the user can neither remove nor create. 
Each level will have its own level Blueprint that the user can use to create 
events that pertain to the whole level. The user can use this graph to call 
events on a specific actor present in the level or play a Matinee sequence. 
Users who are familiar with Unreal Engine 3 (or UDK) should be familiar 
with this concept as this is similar to how Kismet worked in those Engines. 


Å Class Blueprint: Commonly referred to as just Blueprint, is an asset that 
you create inside Content Browser. Once the asset is created, you define its 
behavior visually instead of typing any code. This Blueprint is saved as an 
asset in Content Browser so you can drag and drop this into your world as 
an instance or spawn dynamically in another Blueprint graph. 


Å Animation Blueprint: These are specialized graphs that control the 
animation of a skeletal mesh by blending animations, controlling the bones 
directly, and outputting a final pose in each frame. Animation Blueprints 
will always have two graphs, namely EventG raph and AnimGraph. 


Å EventG raph: This uses a collection of animation-related events to initiate 
a sequence of nodes, which updates the values used to drive animations 
within Animgraph. 


Å AnimGraph: This is used to evaluate the final pose for your Skeletal M esh. 
In this graph, you can perform animation blends or control bone transforms 
using SkeletalC ontrols. 


Å Macro Library: These are containers that can hold various macros or graphs 
that you can use multiple times in any other Blueprint class. Macro libraries 
cannot contain variables or inherit from other Blueprints or be placed in the 
level. They are just a collection of graphs that you use commonly and can be 
a time-saver. If you are referencing a macro in your Blueprint then changes 
to that macro will not be applied to your Blueprint until you recompile your 
Blueprint. Compiling a Blueprint means converting all the properties and 
graphs into a class that Unreal can use. 


Å Blueprint Interface: These are graphs that contain one or more functions 
without implementation. Other classes that add this interface must include 
the functions in a unique manner. This has the same concept of interface in 
programming where you can access various objects with a common interface 
and share or send data to one another. Interface graphs have some limitations 
in that you cannot create variables, edit graphs, or add any components. 
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Getting familiar with the Blueprint user 
interface 


The Blueprint User Interface (UI) contains various tabs by default. In the following 
screenshot you can see the unibed layout of the Blueprint UI: 
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Let's take a look at these tabs: 


A Components 

M y Blueprint 
Toolbar 

G raph editor 

D etails panel 


Do Do Do > 
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Components tab 


Most Blueprint classes can have different types of components. These can be light 
components, mesh components, UI components, and so on. In this section, we will 
see what they are and how we can use them in our Blueprint classes. 


What are components? 


Components are the bits and pieces that make up the whole Actor. Components 
cannot exist on their own but when added to an Actor, the Actor will then have 
access to all the functionalities provided by the component. For example, think 
about a car. The wheels, body, lights, and so on can be considered as components 
and the car itself as the Actor. Then in the graph, you can access the component and 
do the logic for your car Actor. Components are always instanced and each Actor 
instance will have its own unique instance of components. If this were not the case, 
then, if we place multiple car Actors in world and if one starts moving, all the others 
will also move. 


Adding a component 


To add a component to your Actor, click the Add Component button on 
the Components tab. After clicking the button it will show alist of various 
Components that you can add. 


= Components 


+Add Component ~ 


Common 
w Audio 
* Particle System 
® Point Light 
@® Scene 
* Skeletal Mesh 
fy) Static Mesh 
@ Sphere 
W Cube 
Al 
@, AlFerception 
@, AlFerception Stimuli Source 
€ Blackboard 
®, Pawn Noise Emitter 
®, Pawn Sensing 
LACE 
W Audio 
Basic Shapes 
@ Sphere 
© Cube 
P cylinder 
A Cone 
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After adding a component, you will be prompted to give it a name. Components 
can also be directly added simply by dragging-and-dropping from Content Browser 
to the Components window. 


To rename a component, you can select it in the Components tab and press F 2. 


The drag-and-drop method only applies to StaticM eshes, 
vi SkeletalM eshes, SoundC ues, and ParticleSystems. 


With the component selected, you can delete it by pressing the D elete key. You can 
also right-click on the component and select D elete to remove it as well. 


Transforming the component 


Once the component is added and selected, you can use the transform tools (W, E, 
and R) to change the location, rotation, and scale of the component either by entering 
values in the D etails panel or in the Viewport tab. When using moving, rotating, 

or scaling, you can press Shift to enable snapping, provided you have enabled grid 
snapping in the Viewport toolbar. 


A! If the Component has any child components attached to 
Q it then moving, rotating or scaling that component will 
propagate the transformation to all child components too. 
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Adding events for components 


Adding events based on a component is very easy and can be done by different 
methods. Events created in this manner are speci þc to that component and need 
not be tested as to which component is involved: 


Å Adding events from the details panel: When you select the component you 
will see all the events available for that component in the D etails panel as 
buttons. When you click on any of them, the editor will create the event node 
specific for that component in the event graph. 


AL T petails 


Search 

> Variable 

> Transform 
> Sockets 

> Shape 

> Navigation 
> Rendering 
> Physics 

> Collision 

b Tags 

4 Events 


«> Cin C Omi ponent Hit 


Q> On Component Begin Overlap 


» On Component End Overlap 
€> On Begin Cursor Over 
> On End Cursor Over 
> On Clicked 
{> On Released 
<> On Input Touch Begin 
> On Input Touch End 
> On Input Touch Enter 


* On Input Touch Leave 


++ttttettt + + + 


(> Physics Volume Changed 
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Å Adding events by right-clicking: When you right-click on a component, you 
will see Add Event in the context menu. From there you can select any event 
you want and editor will create the event node specific to that component in 
the event graph. 


s. Components d k | j 
+ Add Component = (- o- 


Compile Save 


Ü ThirdPersonCharacter(self) 


ae Viewporn 
fe Add Event 

Add OnComponentHit 

Add OnComponentBeginOverlap 
Copy Add OnComponentEndOverlap 
Gc Bs, Add OnBeginCursorOver 
Add OnEndCursorOver 
Add OnClicked 
Add OnReleased 


Duplicate 


Add OnInputTouchBegin 
Add OninputTouchEnd 
Add OninputTouchEnter 


Open CapsuleComponent.h 
® Find Class in Content Browser 
Add OninputTouchLeave 


Add PhysicsVolumeChangedDelegate 





Å Adding events in the graph: Once you select your component in the M y 
Blueprints tab, you can right-click on the graph and get all the Events for 
that component. 


Event BeginPla ; ; : a6 
5 a ESA an on All Actions for this Blueprint Context Sensitive 


© Event Tick cco LD 


4 Add Event for Box 


4Functions | = 
4 Collision 
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f Constructionscript © Add On Component Begin Overlap 


Macros © Add On Component End Overlap 
4Variables © Add On Component Hit 


4input 
4Components r 
pa 4 Mouse Input 


- RETES © Add On Begin Cursor Over 
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© Add On Clicked 
© Add On End Cursor Over 
© Add On Released 
> Touch Input 
4Physics Volume 
© Add Physics Volume Changed 
> Call Function on Box 


Event Dispatchers 


> Actor 
> Add Component 
> Add Event 





[121] 


Blueprints 


My Blueprints tab 


The My Blueprints tab displays a list of Graphs, Functions, M acros, Variables, and 
so on that are contained within your Blueprint. This tab is dependent on the type of 
Blueprint. For example, a class Blueprint will have EventG raph, ConstructionScript 
Graph, Variables, Functions, M acros, and so on. An interface will only show the list 
of functions within it. A M acro Library will show only the macros created within it. 


Creation buttons 


You can create new variables, functions, macros, event graphs, and event dispatchers 
inside the My Blueprints tab by clicking the shortcut button (+). 


+Add new ~ seach OR 
4a Graphs + 
daa EventGraph 
© Event BeginPlay 
€> Event ActorBeginOverlap 
Q> Event Tick 


4 Functions (18 Overri 


*r ConstructionSeript 


Macros 


4 Variables 
4Components 
Box 
DefaultSceneRoot 


Event Dispatchers 





You can also add them by clicking the +A dd N ew drop-down button. 


Searching in my Blueprint 

The My Blueprint tab also provides a search area to search for your variables, 
functions, macros, event graphs, and event dispatchers. You can search based 
on name, comment, or any other data. 
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Categorizing in My Blueprint 

Itis always a good practice to organize your variables, functions, macros, event 
dispatchers, and so on into various categories. In the My Blueprints tab, you can 
have as many categories with sub-categories. Check the following screenshot: 


+ Add New ~ Ts) <> - 


4Graphs 
ms EventGraph 


ad Functions (41 Ove 


*r ConstructionScript 


Macros 


a Variables 
4 Camera 
4 Components 
FollowCamera 
CameraBoom 
BaseTurnHate 
BaseLookUpRate 
4 Attributes 
4 Health 
Health 
MaxHealth 
> Armor 
CharacterName 
4 Spells 
ActiveSpell 


Event Dispatchers 





ab 


Here you can see how | have organized everything into various categories and 
sub-categories. To set a category for your variables, functions, macros, and event 
dispatchers, simply select them and in the Details panel you can type your new 
category name or select from an existing category. If you need sub-categories 

then you need to separate your sub-category name with a vertical bar key (| ). For 
example, if you want H ealth as a sub-category in Attributes, you can set it like this: 
Attributes | Health. 
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Toolbar 


The toolbar provides access to common commands required while editing 
Blueprints. Toolbar buttons will be different depending on which mode (editing 
mode, play in editor mode, and so on) is active and which Blueprint type you are 
currently editing. 


Graph editor 


Graph editor is the main area of your Blueprint. This is where you add new nodes 
and connect them to create the network that depnes the scripted behavior. More 
information on how to create new nodes and various nodes will be explained later 
on in this book. 


Details panel 


The D etails pane! provides access to properties of the sd ected Components or 
Variables. It contains a search þeld so you can search for a specipc property. 


Blueprint graph types 

Aswementioned before, Blueprints are assets that are saved in Content Browser 
that are used to create new types of Actors or script gameplay logic, events, and so 
on, giving both designers and programmers the ability to quickly iterate gameplay 
without writing a single line of code. In order for a Blueprint to have scripted 
behavior, we need to debne how it behaves using various nodes in graph editor. 
Let's take a quick look at various graphs: 


Å Construction Script G raph: Construction graph is executed the moment 
the Blueprint is initialized and whenever a change happens to any variables 
within the Blueprint. This means that whenever you place an instance of 
the Blueprint in the level and change its transformation or any variable, the 
construction graph is executed. This graph is executed once every time it is 
constructed and again when any of the properties or Blueprint is updated. 
This can be used to construct procedural elements or to set up values before 
the game begins. 


Å Event Graph: This is where all the gameplay logic is contained, including 
Interactivity and dynamic responses. Using various event nodes as entry 
points to functions, flow controls, and variables, you can script the behavior 
of the Blueprint. Event graphs are only executed when you start the game. 
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Å Function Graph: By default, this graph contains one single entry point with 
the name of the function. This node can never be deleted but you can move 
it around freely. Nodes in this graph are only executed when you call this 
function in the construction or event graph or from another Blueprint that is 
referencing the Blueprint that this function belongs to. 


Å Macro Graph: This is like a collapsed graph that contains your nodes. Unlike 
function graphs, macros can have multiple inputs or outputs. 


Å Interface G raph: Interface graphs are disabled and you cannot move, create 
graphs, variables, or components. 


Only class Blueprints have C onstruction Script and it stops executing 
J + when gameplay begins and is considered completed before gameplay. 


Function graph 


Function graphs are node graphs created inside a Blueprint and can be executed 
from another graph (such as Event Graph or Construction Script) or from another 
Blueprint. By default, function graphs contain a single execution pin that is activated 
when the function is called, causing the connected nodes to execute. 


Creating functions 


Function graphs are created through M y Blueprints tab and you can create as many 
functions as you want. 


Inside M y Blueprints tab you can hover your mouse over the functions header and 
click on +Function to add anew function 


MA iy Blueprint 
+ Add New ~ EEE 


a Graphs 
da. EventGraph 
€> Event BeginPlay 
Ç> Event ActorBeginOverlap 
Ç> Event Tick 
4 Functions (18 Overri le) Override + e FINECO 
*r ConstructionScript 
f PureFunctionExample 


f impureFunctionExample 
„f NewFunction_o 


Macros 
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Clicking that button (the yellow highlighted button) will create a new function and 
prompts you to enter a new name for it. 


Graph settings 


When you create a new function and select it, you will get some properties of that 
function, which you can change in the D etails panel. Let's take a quick look at them. 


4 Graph 
Description Description of my funct 


Access Specifier ME 
Pure LI 


ka 





Å Description: Appears as a tooltip when you hover your mouse over this 
function in another graph. 


Å Category: Keeps this function in its given category (for organizational 
purpose only). 


Å Access Specifier: Sometimes when you create functions, you don't want to 
access some of them in another Blueprint. Access specifiers let you specify 
what other objects can access this function. 


Public: This means any object can access this function from anywhere. This is 
the default setting. 


Protected: This means current Blueprint and any Blueprints derived from the 
current Blueprint can access this function. 


Private: This setting means only the current Blueprint can access this function. 


> > D> D> 


Pure: When enabled, this function is marked as a Pure Function and when 
disabled itis an Impure Function. 


° Pure Function will not modify state or members of a class in any way 
and is considered a Constant Function that only outputs a data value 
and does not have an execution pin. These are connected to other 
D ata Pins and are automatically executed when the data on them 
is required. 


° Impure Function is free to modify any value in a class and contains 
an execution pin. 
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The following is a screenshot showing the difference between Pure Function and 
Impure Function: 


. T Pure Function Example 


My Float 


"© Impure Function Example 


Target | self 





Editing functions 


To depne the functionality of the function you need to edit it. You can have as many 
inputs or outputs as you want, and can then create a node network between those 
inputs and outputs to debne the functionality. To add input or output, you prst 
need to select the function either in the M y Blueprint tab or select the main pink 
node when you open the Function Graph. Then, in the Details panel, you will see 

a button labelled N ew that creates new inputs or outputs. 


a) Details 
search OE 
4 Graph 

Description a 
Access Specifier Public sss 
Pure fei 


¥ == Function Example _ E ReturnNode 


4 inputs 


i MyVectorinput ni 
My Vector Input integer Output | | 


My Boolean Input Actor Reference 


4 Outputs 
F irtegeroutput — fænteser >) 
W ActorReference @actor ~ 
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In this screenshot you can see how | added new inputs and outputs to Function 
Example. 


ReturnN ode is optional and will only appear if you have at least one 
output data pin. If you remove all output pins then ReturnN ode is 
ns . . ‘ 
automatically removed and you can still use your function. 


For example, in the following screenshot | created a Blueprint function that appends 
a prebx to my character name so | can use this one single function to change the 
prepx anytime! want. 





Now, back in Event Graph, | call this function on the Begin Play event so! can set 
the character name when the game starts. 


; J Set Team Prefix 
© Event BeginPlay 


D 


Target [self] Name with Prefix 


Prefix [WTH] 





[ 128 ] 


Chapter 6 


Macro graph 

Macro graphs are essentially collapsed graphs of nodes, which contain an entry 
point and exit point designated by tunnel nodes but cannot contain variables. M acro 
graphs can have any number of execution or data pins. 


Macros can be created inside a Class Blueprint or Level Blueprint like functions or 
you can organize your M acros in a Blueprint M acro Library, which can be created in 
Content Browser. 


Blueprint M acro Library can contain all your M acros in one place so you can use 
them in any other Blueprint. These can be real time-savers as they can contain most 
commonly used nodes and can transfer data. But changes to a macro graph are only 
reyected when the Blueprint containing that macro is recompiled. 


To create a macro library you need to right-click in Content Browser and select 
Blueprint M acro Library from the Blueprints sub-category. 


#8 New Folder 


ott Clas 
a. New C++ Class... 


reate Basic Asset 
AA Blueprint Class 
2O Level 

= Material 


+ Particle System 


Animation 


> a : 
RA Blueprint Class 


Materials & Textures > 


Sounds > 
fi Blueprint Function Library 
Physics > 


ser Interfac ; 
User Interface 4 Fe Blueprint Interface 
+ 


Miscellaneous 


Paper2D b ry 


eS Enumeration 


= | 
b Structure 
-H : 
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Once you select that option you have to select a parent class for your Macro. M ost of 
the time we select Actor as the parent class. After the selection, you will be prompted 
to type a name for your Macro library and save It. 


If you just created your Macro library, the editor will create a blank Macro named 
NewM acro_0 and will be highlighted for you to rename. 


As you did with functions, you can type a description and deþne a Category for your 
Macro. You also get an option to debnea color for your Macro using Instance Color. 


In the following screenshot you can see! created a Macro with multiple outputs and 
deþned a Description, Category, and an Instance Color for the M acro: 


+Aé4 tw - TS <> - 
d Maci os 


4 My Macro 


J is Packaged for Distribution 





In any other Blueprint! can now get this Macro and use it. If you hover you mouse 
over the Macro, you can see the description you set as a Tooltip. 
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All Actions for this Blueprint Context Sensitive > 
Ce: 
È Input 
> Leap Motion 
> Live Streaming 
> LOD 
b Math 
ai My Macro 
T$ CheckGameBuild 


> Networking Checks if game is for Shipping release. 
> Niagara 


> Online 

> Painting 

> Pawn 

> Physics 

> Physics Volume 
> Rendering 

> Replication 

b Slot 

b Sprite 

> Steam VR 


Fe CheckGameBuild 


[> Check Build Distribution Build [> 


Development Build [> 





Interface graph 


Interface graphs are a collection of functions without any implementation, which 

can be added to other Blueprints. Any Blueprint class implementing an interface 

will depnitely contain all the functions from the interface. It is then up to the user to 
give functionality to the functions in that interface. Interface editor is similar to other 
Blueprints but you cannot add new variables, edit the graph, or add any components. 


Interfaces are used to communicate between various Blueprints that share specifc 
functionality. For example, if the player is having a Flame Thrower gun and in 

the game you have Ice and Cloth, both can take damage but one should melt 

and the other should burn. You can create a Blueprint Interface that contains a 
TakeWeaponFire function and have Ice and Cloth implement this interface. Then, 

in Ice Blueprint, you can implement the TakeW eaponFire function and make the ice 
melt and, in Cloth Blueprint, you can implement that same function and make the 
cloth burn. Now when you are bring your Flame Thrower you can simply call the 
TakeW eaponFire function and it calls them in those Blueprints. 
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To create a new interface, you need to right-click on the Content Browser and select 
Blueprint Interface from the Blueprints sub-category and then name it. 


In the following example! named it BP_T estl nterface: 


Folder 

#8 New Folder 
C++ Class 

W New C++ Class... 
mport Asset 


Fl Import to /Game... 


Create Basic Asset 
PA Blueprint Class 


Material 


+ Particle System 
Aamen A 


Animation 
J g . 
: AA Blueprint Class 
Materials & Textures : 


Bounds f~ Blueprint Function Library 


Physics 


User Interface A 


Miscellaneous 


Paper2D ry Blueprint Macro Library 


re Enumeration 
i Structure 
Si 





If you just created your interface the editor will create a blank function named 
NewFunction_0, which will be highlighted for you to rename. If you implement this 
interface on any Blueprint then it will have this function. 
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In this example, | created a function called M yInterfaceFunction. We will use this 
to simply print out the Actor name that implements this interface. 





f Details 


seach OD o- 


4 Graph 


Default v 


¥ 


Description 


Category 


4 Inputs 

; Qacon e 
4 Outputs 

W OwnerActorLabe (æ@sSting v x 


To create functionality for this function, we prst need to implement this interface in a 
Blueprint. So open your Blueprint where you want this to be implemented and select 


Class 


Settings in the Toolbar. 


J- Toolbar 


Compile 


® 


Find in CE 


asf 


Search 





mlas Satires 


Now the D etails panel will show the settings for this Blueprint and, under the 
Interfaces section, you can add your interface. 


T 


petals 


4 Blueprint Options 


Run Construction £ 


Blueprint Category [| an? 
+ Ü 


Hide Categories 0 elements 


4 Class Options 


Parent Class 


4 Interfaces 


a 


P) 


Implemented Interfaces 
No Interfaces 


Inherited Interfaces 
No Interfaces 


FA AlPerceptionListenerinterface 


PA AlSightTargetinterface 
ae a z r z 


A Genericleam 
PA Interface_PostProcessVolume 

FA SlateWidgetStyleContainerinterface 
FA TurnBasedMatchinterface 
©) Tutorial_BP_Interface 


m] 
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Once you add that interface, the M y Blueprints tab will update to show you the 
interface functions. Now all you have to do is double-click on the function to open 
the graph and add functionality. 


BA My Blueprint 


+ Add New + 


4Graphs 
da. EventGraph 
«> Event BeginPlay 
€> Event ActorBeginOverlap 
€> Event Tick 
4 Functions (18 Overridabl 
*r ConstructionScript 
f SetTeamPrefix 
4interfaces 
M MyinterfaceFunction 
Macros 


4 Variables 
ad Components 
Sphere 
DefaultSceneRoot 
CharacterName 


Event Dispatchers 





The reason why M yInterfaceFunction appears in the M y Blueprints tab is because 
that function contains an output value. If you have an interface function without 
an output then it won't appear in the M y Blueprints tab. Instead it appears under 
Events when right-clicking in your Blueprint. For example, in that same interface | 
created another function without output data. 
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f dreother inger toceF unc born 


This Another! nterfaceFunction will not appear in the M y Blueprints tab because it 
has no output. So, to implement this function in your Blueprint, you have to add this 


as an event. 


MA My Blueprint 
Fete eae SeATC! 


4Graphs 
465 EventGraph 

© Event BeginPlay 

© Event ActorBeginOverlap 

©} Event Tick 

© Event Another Interface Function 
4Functions 

œf ConstructionScript 

f SetTeamPrefix 
Ainterfaces 

Ff MyinterfaceFunction 


Macros 


4Variables 
4 Components 
Sphere 
DefaultSceneRoot 
= CharacterName 
Event Dispatchers 
F 


© Event Another Interf: 


From BP Test | 


ace Function 


fale 
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All Actions for this Blueprint Context Sensitive 


Select a Component to see available Events & Functions 


> Actor 
D Add Component 
4 Add Event 
> Actor 
> Collision 
> Game 
> Mouse Input 
> Touch Input 
> Add Custom Event... 
© Event Another Interface Function 


Event BeginPlay 
© Event Destroyed 
© Event End Play 
© Event Tick 

> AI 
> Animation 
D Audio 
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Blueprint node references 


The behavior of a Blueprint object is deoned using various nodes. Nodes can be 
Events, Function Calls, Flow Control, Variables, and so on that are used in the 
graph. Even though each type of node has a unique function, the way they are 
created and used is common. 


Nodes are added to the graph by right-clicking inside the graph pane! and selecting 
the node from the Context M enu. If a component inside Blueprint is selected, events 
and functions supported by that component are also listed. 


All Actions for this Blueprint Context Sensitive 
| arch p 


Select a Component to see available Events & Functions 


> Actor 

> Add Component 
> Add Event 

b Al 

t Animation 

> Audio 

> Call Function 

> Camera 

> Canvas Render Target 2D 
> Class 

t Collision 

> Components 

[> Data Table 

> Debug 

> Development 

> Effects 

> Event Dispatchers 
> Focus 





After anode is added you can select it and move it around using the left mouse 
button. You can use Ctrl to add or remove from the current selection of nodes. 
Clicking and dragging inside the graph creates a M arquee Selection that adds 
to the current selection. 


Nodes can have multiple inputs and outputs and are of two types: Execution Pins 
and D ata Pins. 


Execution pins start the yow of execution and when the execution is completed it 
activates an output execution pin to continue the yow. Execution pins are drawn 
as outlines when not wired and solid white when connected. 


Execution Pin Wired J - 





Execution Pin Unwired [> 
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Data pins are nodes that transfer (such as taking and outputting) data from one 
node to the other. These nodes are type specipc. That means they can be connected 
to variables of the same type. Some data pins are automatically converted if you 
connect them to another data pin that is not of the same type. For example, if you 
connect af! oat variabletost ring, the Blueprint editor will automatically insert 
afloat toastring conversion node. Like execution pins, they are drawn as an 
outline when not connected, and a solid color when connected. 


Connected Pin 





Unconnected Pin 


Node colors 


Nodes in Blueprint have different colors that show what kind of node It Is. 


A red-colored node means it's an event node and this is where execution starts. 


© Event BeginPlay 


D 





A blue-colored node means it can either be a function or an event being called. These 
nodes can have multiple inputs or outputs. The icon on top of the function will be 
changed based on whether it's a function or event. 





A purple-colored node can neither be created nor destroyed. You can see this node in 
Construction Script and Functions. 


“BB construction Script 
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A grey node can be aM acro, Flow Control, or Collapsed node. 


True [> 


Condition False [> 





A green-colored node usually means a Pure function used to get a value. 
J Get Owner 


Target | calf | Return Value 





A cyan-colored node means it's a cast node. This node converts the given object 
to another. 


+ Cast To Actor 


L> 
k 


Object Cast Failed [> 


As Actor 





Variables 


Variables are properties that hold a value or an object reference. They can be accessed 
inside the Blueprint editor or from another Blueprint. They can be created to include 
data types (f | oat ,i nteger,Bool ean, and so on) or reference types or classes. Each 
variable can also be an array. All types are color coded for easy identipcation. 


Math expression 


M ath expression nodes are essentially collapsed nodes that you can double-click 

to open the sub graph to see the functionality. Whenever you rename the node, the 
new expression is parsed and anew graph is generated. To rename the node, simply 
select it and press F 2. 


To create a M ath Expression node, right-click on the graph editor and select Add 
M ath Expression node. You will then be prompted to type your M ath Expression. 


[ 138 ] 


Chapter 6 


For example, let's type this expression: (vector(x, y, z)) + ((a +1) * (b + 1)) and 
press Enter. 


(vector(x, y, Z)) + ((a + 1) + (b + 1)) 


> xS Return Value | 


C Y[ ] 


>z0 
>a[] 
B[ ] 





You will now seethat the M ath Expression node has automatically parsed your 
expression and generated proper variables and a graph from your expression. 





The following operators are supported and can be combined with logical and 
comparison operators to create complex expressions: 


A 
A 
A 
A 
A 


M ultiplicative: * / , % (modulo) 
Additive: +, - 

Relational: < > <= >= 

Equality: — (equal), != (not equal) 
Logical: | | (or), && (and), ^ (power) 
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Etgcvpi ‘qwt'OtuvDmor tipvercuu 

Now that we have an idea of what Blueprint is and what it does, let's create a simple 
Blueprint actor that spins on its own and destroys itself after a few seconds with a 
particle effect and sound. After creating our Blueprint, we will drag and drop this 
into the world and wewill also use the Level Blueprint to dynamically spawn this 
Blueprint while running the game. 


Creating a new Blueprint 


To create this Blueprint, prst right-click inside Content Browser and select Blueprint 
Class. Once you click that you will be prompted to select a parent class for the 
Blueprint. You need to specify a parent class for your Blueprint as it will inherit 

all properties from that parent class. 


Even though you can choose all existing classes (even other Blueprint classes), 
let's take a look at the most common parent classes: 
Å Actor: An Actor-based Blueprint can be placed or spawned in the level 


Pawn: Pawn is what you can call an agent which you can possess and 
receives inputs from the controller 


Character: This is an extended version of Pawn with the ability to walk, run, 
jump, crouch, and more 


Player Controller: This is used to control the Character or Pawn 
Game M ode: This defines the game being played 


Actor Component: This is a reusable component that can be added to 
any actor 


D> > > > D> D> 


Scene Component: This is a component with scene transform and can be 
attached to other scene components 


In this example, we will use the Actor class as our parent because we want to place it 
in the level and spawn at runtime. So choose Actor class and Unreal will create and 
place your new Blueprint in Content Browser. Double-click on your newly created 
Blueprint and this will open the Blueprint editor. By default, it should open the 
Viewport tab but if it doesn't then simply select the Viewport tab. This is where 

you can see and manipulate all of your components. 


Now we need a component that will soin when this Blueprint is soawned. On the 
Components tab, click Add Component and select Static M esh component. After 
you add the component, rename it to Mesh Component (you can choose whatever 
name you want but, for this example, let's choose that name) and note how the 

D etails panel has been populated with Static M esh properties. 
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In the Details panel, you can pnd the section that corresponds to your component 
type where you can assign the asset to use. 


But, in this example, instead of directly assigning a mesh in the Components tab, we 
create a Static M esh variable and use that to assign the mesh in the graph. This way, 
we can change the mesh without opening the Blueprint editor. 


In the M y Blueprints tab, create a new variable and set the type to Static M esh 
(make sure to select reference). 


my In versions before Unreal Engine 4.9, you can search for Static M esh and 
Q simply select the reference. There was no additional options to select 
before 4.9. 


After that, rename that variable to M y M esh. Since this variable is used to assign the 
asset to use with our Static M esh component, let's expose this variable so that we can 
change it in the D etails pane after placing itin world. To expose this variable, select 
it and enable Editable in the D etails pane! inside the Blueprint editor. After making 
it editable, compile the Blueprint (shortcut key: F7) and you will be able to assign 

a default mesh for the M y Mesh variable. For this example, let's add a simple cube 
Static M esh. 


Now that our variable is set, we can assign it to our Static M esh component. Since 
we know that Construction Graph is executed every time this Blueprint is initialized 
and whenever a variable or property is changed, that is where we are going to assign 
the mesh for our Static M esh component. So, open the Construction Graph and: 

Å Right-click on the graph editor and search for the G et M esh component. 

Å Select Get Mesh component from the context menu. 


Å Click and drag from the output pin and release it. You will now see a new 
context menu and, in that resulting menu, search for Set Static M esh and 
select it. 


Å Right-click again on graph editor and search for Get My Mesh. 


Å Select Get My Mesh and connect the output pin to the input (New Mesh) of 
the Set Static M esh Blueprint node. 


Å And, finally, connect the execution pin of Construction Script to Set Static 
M esh Blueprint node and press Compile (shortcut key: F7). 
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If you check the Viewport tab after compiling, you will see your new mesh there. 
From this point, feel free to drag this Blueprint to the world and in the D etails panel 
you can change M y M esh to any other Static M esh. 


| Q Press Ctrl+£ to open the associated editor of the object you have selected | 
in world. 


Spinning static mesh 
In Blueprint editor, there are a couple of ways to rotate a mesh and in this section we 
will look into the simplest way, which is using a Rotate M ovement component. 


Open the Blueprint if you have closed it and add anew component called Rotating 
M ovement. This component will make this Actor continuously rotate at a given 
rotation rate optionally around a specibed point. This component has three main 
parameters that can be changed in the Blueprint graph. They are: 


Å Rotation Rate: The speed at which this will update the Roll/ Pitch/ Yaw axis. 


Å Pivot Translation: The pivot point at which we rotate. If set to zero then we 
rotate around the object's origin. 


Å Rotation in Local Space: Whether rotation is applied in local space or 
world space. 


You can create two new variables (Rotator and V ector variables) and make them 
editable so you can change It in the D etails pane in world. The þnal graph should 
look like this: 


Mesh Component 


i J Set Static Mesh 
A E 


> È e—a =f 


Target Pa Rotation Rate © Pivot Translation 
y 


My Mesh New Mesh / Target Target 


/ 
ee 
Rotation Rate @—~ 


a à 
Rotating Movement 
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Destroying our Blueprint Actor after 
some seconds 


Once we place or spawn this Actor in world we will destroy this actor with a particle 
effect and sound. To do that: 


Å Create anew variable (f | oat ) and name it D estroyA fter. Let's giveita 
default value of five seconds. 


A Goto Event Graph and add anew event called Event BeginPlay. This node 
is immediately executed when the game starts or when the actor is spawned 
in the game. 


Å Right-click on the graph editor and search for Delay and add it. Connect 
Event BeginPlay to the Delay node. This node is used to call an action 
after a number of specified seconds. 


Å TheDelay nodetakes af! oat value, which is used for the duration. After 
the duration runs out, execution is continued to the next action. We will 
connect our D estroyA fter variable to the duration of Delay. 


Å Right-click on the graph and search for Spawn Emitter At Location. This 
node will soawn the given particle effect at the specified location and 
rotation. Connect D elay to this node and set a particle effect by assigning 
it in the Emitter Template. To set the location, right-click on the graph and 
search for G etA ctorLocation and connect it to Location pin. 


Å Right-click on the graph and search for Spawn Sound At Location. This 
node will soawn and play asound at the given location. Connect Spawn 
Emitter node to this one. 


Å And, finally, to destroy this actor, right-click on the graph editor and search 
for D estroyA ctor and connect it to Spawn Sound node. 


The þnal graph should look like this: 


T Spawn Emitter at Location 
b 


Emitter Temple 


E Loton 
J Spawen Sound of Location 


k! 
Rotation al 
z goj aoiz oo 3 
Senn 


kto Destroy RA 





Now, when you place this actor in world and start the game you will see it spin 
and, after þve seconds (or the value you used in Destroy After), this actor will be 
destroyed after soawning the particle effect and sound. 
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Spawning our Blueprint class in Level 
Blueprint 


We will now see how we can spawn this Blueprint Actor in world while the game is 
running, instead of directly placing when editing. 


Before we continue we will make a change to the D estroyA fter variable in our 
spinning Blueprint Actor. Open our spinning actor's Blueprint editor and, in 
Variables, select the D estroyA fter variable and, in the D etails panel, enable the 
Expose On Spawn setting. 


4Variables 
> Components 
MyMesh 
= RotationRate 
Pivot 


Event Dispatchers 


T Details 


4 Variable 
Variable Name 
Variable Type 
Editable 
Tooltip 
Expose on Spawn 
Private 
Expose to Matinee 
Category 
Slider Range 
Value Range 


Replication 


4 Default Value 


Destroy After 





This setting means this variable will be exposed in the Spawn Actor node. 
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Open your level and, on the toolbar, click the Blueprints button and select O pen 
Level Blueprint. In Level Blueprint perform the following steps: 


Å Right-click on the graph and search for Event BeginPlay and add it. 


Å Right-click on the graph and search for Spawn Actor from Class and add it. 
This node will soawn the given actor class at the specified location, rotation 
and scale. 


Å Intheclass pin set the class to our Rotating Blueprint Actor. Note how the 
Destroy After variable is now exposed to Spawn node. You can now adjust 
that value from that Spawn node. 


Å Drag from the Spawn Transform node and release the left mouse button. 
From the resulting context menu, select M ake Transform. The transform 
node contains 3D transformation including translation, rotation, and scale. 
For this example, let's set the Location to 0,0,300 so that is this Actor will be 
Spawned 300 units above the ground. 


The resulting graph should look like this: 


© Event BeginPlay C @ SpawnActor BP Rotate Component 
>» ———_—_——— D D 
Class Return Value 
BP Rotate Co 


iiw 


“ Make Transform 


; Spawn Transform 
Location Return Value 


Collision Handling Override 
Default v 
Owner 

Select A 


T” v 


x 1.0][y 1.0]{2 1.0] > Destroy After [5.000000 


Instigator 


et w 





If you play (Alt+P ) or simulate (Alt+S) you will see this rotating A ctor spawn 
300 units above the ground and spinning. 
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Summary 
In this chapter, we have learned what components are and how we can use them 
to deþne a Blueprint Actor. We also learned about Blueprint nodes and how you 
can create them. From what you have learned in this chapter, you can take it even 
further by: 
Å Spawning this actor when overlapping a trigger volume placed in the level 
Å Playing a particle and sound effect when spawning this Blueprint 


Å Applying damageto a player if the player is in a certain radius 


In the next chapter, we will use M atinee to create a cut scene. 
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Matinee provides the ability to keyframe various properties of actors over time, 
either dynamically in gameplay or in cinematic game sequences. The system is based 
on specialized tracks in which you can place keyframes on certain properties of an 
actor. The user interface (UI) of Matinee is similar to other nonlinear video editing 
software, which makes it easier and familiar for video editors. 


In this chapter, we will create a Matinee sequence and learn how we can play it 
through Level Blueprint. So to get started, let's start Unreal Engine 4 and createa 
new project based on Third Person Template. 


Creating a new Matinee 


To open the Matinee UI, we prst need to create the M atinee asset. You can create 

a Matinee asset by clicking on the M atinee button and selecting Add M atinee in 

the level editor toolbar. When you click on it, you might get a warning saying that 
Undo/ Redo data will be reset. This is because, while you are in the Matinee mode, 
some changes are translated into keyframes and editor needs to clear the undo stack. 
Click on Continue and anew Matinee Actor will be placed in the level and the 
Matinee editor will open. Let's take a closer look at the Matinee window: 


2.8.9.5. p>. a. 


settings Blueprints Matinee Build Play Launch 


MEW 


ks 
= 


Creates a new matinee actor to edit 


Creating new Matinee Actor 





7 aÁ 


Matinee 


This is the M atinee Actor icon: 





Matinee Actor placed in world 


After creating anew Matinee Actor, it will automatically open the M atinee Window. 


If it doesn't, then select the M atinee Actor in world and click on Open M atinee in 
the Details pang. 


2 Details 


SH MatineeActor pm 
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4 Transform 
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Scale 
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F 
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Matinee window 


Let's take a quick look at the M atinee window: 





The Matinee window consists of: 


Å Toolbar: This contains all the common buttons for Matinee editor, such as 
playing the Matinee, stopping it, and so on. Let's take a closer look at the 
toolbar buttons: 


° Add key: This adds anew keyframe at the current selected track. 


° Interpolation: This sets the default interpolation mode when adding 
new keys. 


° Play: This plays a preview from the current position in the track view 
at normal speed to the end of the sequence. 


° Loop: This loops the preview in the loop section. 


° Stop: This stops the preview playback. Clicking twice will rewind the 
sequence and place the time bar at the beginning of Matinee. 


° Reverse: This reverses the preview playback. 

° Camera: This creates a new camera Actor in world. 

° Playback Speed: This adjusts the playback speed. 

° Snap Setting: This sets the timeline scale for snapping. 
° Curves: This toggles curve editor. 


[ 149 ] 


Matinee 


Snap: This toggles snapping of time cursor and keys. 


Time to frames: This snaps the timeline cursor to the setting selected 
in the Snap Setting dropdown. It is only enabled if Snap Setting is 
using frames per second. 


Fixed Time: This locks playback of Matinee to the frame rate 
specified in Snap Setting. It is only enabled if Snap Setting is using 
frames per second. 


Sequence: This fits the timeline view to the entire sequence. 
Selected: This fits the timeline view to the selected keys. 
Loop: This fits the timeline view to the loop section. 


Loop sequence: This automatically sets the start and end of the loop 
section to the entire sequence. 


End: This moves to the end of the track. 
Record: Opens the M atinee Recorder window. 


M ovie: This allows you to export the Matinee as a movie or image 
SEQUENCES. 


Since Matinee is similar to other nonlinear video editors, you can use the 
following common shortcut keys: 


fe) 


(0) 


fe} 


fe) 


fe} 


J to play the sequence backward 

K to stop/ pause 

L to play the sequence forward 

Plus (+) to zoom in to the time line 
Minus (-) to zoom out of the time line 


Curve editor: This allows you to visualize and edit the animation curves 
used by tracks in the M atinee sequence. This allows for bne control over 
properties that change over time. Certain tracks with animation curves can 
be edited in curve Editor by toggling the Curve button. Clicking on it will 
send the curve information to curve editor where the curve will be visible 
to the user. 
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Å Tracks This is the heart of the Matinee window. This is where you set all 
your keyframes for your tracks and organize them into tabs, groups, and 
folders. By default, when you create a Matinee, the length is set to 5 seconds. 


i Frau 


Al Cameras Skeletal Meches Lighe Particles Sounds Events 





° Tabs: These are used for organization purposes. You can put your 
tracks into various tabs. For example, you can put all your lights in 
your Matinee to the Lights tab, camera to the Camera tab, and so on. 
The All tab will show all tracks in your sequence. 


° Track List: This is where you create tracks that can create keyframes 
in the timeline and organize them into different groups. You can also 
create new folders and organize all groups into separate folders. 


° Timeline Info: This shows information about the timeline including 
the current time, where the cursor Is, and the total length of the 
sequence. 


° Timeline: This shows all the tracks within the sequence and this 
is where we manipulate objects, animate cameras, and so on using 
keyframes. The green area shows the loop section (in between the 
green markers). At the bottom of track view, you can see a small 
black bar, which is called the Time Bar. If you click on and hold 
it, you can scrub the timeline forward or backward, which allows 
you to quickly preview the animation. To adjust the length of the 
sequence, you move the far right red marker to the length you want 
this Matinee to be. 
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Manipulating an object 


Matinee can be used to create cut scenes where you move the camera and manipulate 
objects or it can be used for simple gameplay elements such as opening doors and 
moving lifts. In this example, we will seehow wecan movea simple cube from one 
location to another location. 


From Engine Content, we will drag and drop the Cube mesh into our world. This is 
located intheEngi ne Content\BasicShapes folder. 


== (Content Browser 


BeAddNew> & impot B SaveAl € >| & Engine Content » BasicShapes + 


eg Search Folders PPB Besa Search BasicShapes 


üs Content 7 
4@e Engine Content f 
e fia ArtTools Ee s as 
Gane Cube 


BE BufferVisualization BasicShape 
ry Baie Material 
ie Editor BlueprintResources 


Cylinder Sphere 





To get Engine Content, you need to enable it in Content Browser. 


1. Atthe bottom right corner of Content Browser, you can see View Options. 
2. Click on it and then enable Show Engine Content. 


View Type 
® Tiles 
List 
ll Columns 
Folders 
W Show Folders 
| Show Developers Folder 


Show Plugin Content 


Show Collections Show the engine content in the view. 


Thumbnails 
Scale —§—————_ 


Thumbnail Edit Mode 


| Real-Time Thumbnails 





> View Options + 


After placing our Cube in world, let's open the M atinee editor window. Makesure 
the Cube is selected in world and right-click in the track list area and select Add 
New Empty Group. You will now be prompted to type a name for your group. Let's 
call it Cube _M ovement. 
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_ Notethat if you see a notipcation at the bottom-right corner of 
aN your screen saying Cube M obility has been changed to M ovable, 
7 don't panic. Actors that are being manipulated in M ati nee must 
set the M obility to M ovable. 


If you click on this group in Matinee now, you can see the Cube in world will be 
automatically selected for you. This is because, when we created the group, we had 
the Cube selected in world and whatever object you have selected in world will 
automatically be hooked to the group you create. 


To move the cube in world, we need to add aM ovement Track to our Cube_ 
M ovement group. To create this track: 


1. Right-click on our Empty Group (Cube Movement). 
2. Select Add New Movement Track. 


= Tracks 


All Cameras Skeletal Meshes Lights Particles Sounds Events 


cube Mion 


Actors b 


Add New Bool Froperty Track 

Add New Event Track 

Add New Animation Track 

Add New Float Anim BP Parameter Track 
Add New Float Material Parameter Track 
Add New Float Particle Param Track 
Add New Float Property Track 


Add New LinearColor Property Track 

Add New Particle Replay Track 

Add New Toggle Track 

Add New Color Property Track 

Add New Sound Track 

Add New Vector Material Parameter Track 
Add New Vector Property Track 


Add New Visibility Track 


Cut 


Copy 


Rename Group 
Duplicate Group 


Delete Group 


a pü- 


Create Group Tab Lo 
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This will add anew movement track to our Empty Group and will set the current 
position of our cube as the prst keyframe. 





The small triangle in the beginning of the timeline is the keyframe 


Now, we want the cube to move to the right by some distance and, by the end of this 
sequence, it should come back to its default position. So let's scrub the time bar to the 
middle of the sequence (since the default length is 5 seconds long, we will move the 
time bar to 2.5) and go back to Viewport editor. There, we select and move the cube 
by some distance to the right side (Y axis) and press Enter. Note that now Matinee 
has created a new keyframe for you at the time slot 2.5 and you will see a dotted 
yellow line that represents the movement path of the cube. 
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To set the keyframe at the exact time (for example, precisely at 2.5) you can left-click 
on the key frame to select it and then right-click and select Set Time. You will now be 
prompted to enter the new timeto set the keyframe. Here, you can type and set 2.5. 
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If you scrub the time bar now, you will see the cube move from its original position 
to the new position that we keyframed at time 2.5. N ow, to get the cube back to 

its original position at the end of the sequence, wecan simply copy paste the prst 
keyframe to the end of the sequence. To do so, click on the prst keyframe and press 
Ctrl+C to copy it. Then, scrub the time bar to the end of the sequence and press 
Ctri-+V to paste it. The pnished Matinee should look like this: 


= Tracks 
All Cameras Skeletal Meshes Lights Particles Sounds Events 


Gube Movement fe 


Le ioveriant a 





If you hit Play in the toolbar now, you will see the cube move from its original 
location to the new location and then, by the end of sequence, it will go back to Its 
original location. 


Now that our Matinee is ready, we will see how to play the Matinee in game. What 
we are going to do is place a trigger box in level and, when our player overlaps it, 
Matinee will play. When our player steps out of the trigger box, M atinee will stop. 


To place a trigger box in world, you need to drag it and drop it into the viewport 
from the M odes tab (which is under Place in the Volume category). If you don't 
have the M odes tab, then: 

1. Press Shift+1 to open it (make sure your viewport is in focus). 

2. In the M odes tab, go to the Place mode (Shift+1). 

3. Select the Volumes tab. 

4. Drag and drop the Trigger Volume box. 
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u 


Fila Edit Windinw 


air Modes 


Feely risa Audio Volume 


Basic 


Lights i Blocking Volume 


Visual Effects 
Camera Blocking Volume 


BSP 
Volumes ¥ Cull Distance Volume 
All Classes 
Hierarchical LODVolume 
dll ZVolume 
Level Streaming Volume 
| Lightmass Character Indirect Detail Ve 
Lightmass Importance Volume 
Nav Mesh Bounds Volume 
Nav Modifier Volume 
Pain Causing Volume 
Physics Volume 
Post Process Volume 
Precomputed Visibility Override Volurr 
Precomputed Visibility Volume 


Trigger Volume 
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Once the trigger box is placed in world (feel free to adjust the size of the trigger box), 
right-click on it and navigate to Add Event | OnActorBeginOverlap. 


Open TriggerVolume.h 


@ View Documentation 
Select OnTakeAnyDamage 
Edit OnTakePointDamage 
Visibility 
Level 

ace Actor OnActorEndOv : : ee ; 
Eee nee Called when another actor begins to overlap this actor, for example a player walking into a trigger. 
Replace Selected Actors with OnActorHit For events when objects have a blocking collision, for example a player hitting a wall, see ‘Hit’ events. 
"eee note components on both this and the other Actor must have bGenerateOverlapEvents set to true to generate overlap events. 
Attach To sti 
: OnBeqinCursorOver 
Transform z 


Pivot 


OnEndCursorOver 
OnClicked 


OnReleased 


Play From Here 


Level Blueprint E 


OninputTouchBegin 


OninputTouchEnd 
OnInputTouchEnter 


OnInputTouchLeave 


OnDestroyed 





OnEndPlay Laval: Testrnap (Persistent) 


This will add anew Overlap Event for our Trigger Volume in Level Blueprint. 
Since we need to stop the Matinee after exiting the trigger, we will right-click again 
on the Trigger Volume and navigate to Add Event | OnActorEndOverlap. We now 
have two events (Begin Overlap and End Overlap) in our Level Blueprint. 
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© OnActorBeginOverlap (TriggerVolume) O 


D 


Other Actor 


© OnActorEndOverlap (TriggerVolume) O 





D 


Other Actor 


As you can see, both overlap events give us the actor that is currently overlapping 
this Trigger Volume. We will use this information to play the Matinee only when a 
character is overlapping. To do so, we will have to follow this process: 


L. 


2. 


Click and drag from the other Actor pin in the O nActorBeginO verlap event. 
From the resulting context window, type Cast to Character and select it. 


Connect the execution pin of OnActorBeginO verlap to the Cast node we 
just created. 


To play the M atinee, we þrst need to create a reference of it in Level 
Blueprint. To do so, select the M atinee icon in world and right-click inside 
the Level Blueprint. From the resulting context window, select Create a 
reference to M atinee Actor. This will add a new node, which is referred to 
the M atinee Actor in world. From this node, drag a new wire and type Play 
and select it. 


Connect the output (unnamed) execution pin of the Character node to the 
Play node of Matinee. 


To stop the Matinee when exiting the trigger, you can do the same setup as 
previously, but instead of the play node, use the Stop node. 
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The pnal graph should look like this: 


© OnActorBeginOverlap (TriggerVolume) | >» Cast To Character 


| i 2 È 
Other Actor @ ——— @ Object Cast Failed [> 


As Character O» 


= i} MatineeActor 


© OnActorEndOverlap (TriggerVolume) a »+ Cast To Character 


>»>—» b \— p 
Other Actor @ - @ Object Cast Failed [> i ie @ Target 


As Character ©» 





Now, when you play the game and overlap the trigger, our Matinee will play. 





Cutscene camera 


Since you have learned how to create a Matinee and move an object, it is time to 
learn how to create a simple cut-scene. In this section, we will create a camera that 
focuses on the cube when Matinee is triggered. 
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To create a camera, let's prst position the viewport camera at the right location. In 
your editor Viewport, navigate to the place where you want the M atinee camera to 
be. In the following screenshot, you can take a look at where! placed the camera: 


(=) Peepecine)]( @ Lt) Show) cn oE @ B CEDE 


$ 


Level: Testmap (Persistent) 





After navigating to your desired location, open the M atinee window. On the toolbar, 
click on the Camera button (this will prompt you to enter anew group name) to 
create a camera at your current Viewport camera location. 


AL f H Mie tneeActor 


File Edit Playback View Window Help 


at Interpolation: i C) -= a SY Playback Speed: Snap Setting: 


ULG AA cuveAutoClamped ~ [MG CRMC Carers gm 100% x 


! + t p p= Create Camera Actor at Current Camera Location 
fe +Q> | “a = = 





This will also create a new Camera group with two tracks. They are Field of View 
(FOV) and M ovement. Since we don't use the FOV track, you can right-click on it 
and select D elete Track, or simply press D elete to remove it from the track list. 
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With the M ovement Track of the camera selected, scrub the time bar to the end of 
the sequence. Then in the editor Viewport, select the camera created by Matinee and 
move it to a new location. In this example, | moved the camera to the right side and 
rotated it by 30 degrees. In the following screenshots, you can see the initial location 
of the camera and the new location at the end of the sequence. 


All Cameras Skeletal Meshes Lights Particles Sounds Events 


Guse Movement 


VyCamere 


: See 


| 
| 
| 
| 


All Cameras Skeletal Meshes Lights Particles Sounds Events 
Cube Movement ad 
A | 
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Mycamere - 
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If you play now and trigger the M atinee from the Trigger V olume we placed earlier, 
you will see the cube moving as usual but you will not see it from the camera 
perspective. To see it through the camera we placed now, you need to add a Director 
Track to your Matinee. Let's take a look at what a Director Group Is. 


Director group 


Director group serves the main function of controlling the visual and audio of your 
Matinee. The important function of this group is to control which camera group is 
chosen to be seen in the sequence. We use this group to cut between one camera and 
the next when we have multiple cameras in M atinee. 


To create a new D irector Group, right-click on the track list and select Add New 
Director Group. A new separate group will be opened on top of all other groups. 





Since we only have one camera in this group, we will add that one to our director 
track. Select the director track and press Enter. A new pop up will ask you which 
track to choose, so select M yC amera group (this is the group we created using the 
Camera button in Matinee toolbar). The name M yCamera was something | chose. A 
new keyframe will be added to the director track that says M yC amera [Shot0010]. 
This means that whenever this Matinee is played, you will see through the 

M yCamera group. Later, if you add more cameras, you can switch between cameras 
in Director Group. 
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The end result should look like this: 





Now, if you play the Matinee in the game, you will see it through the new 
Camera view. 





Sometimes, when cutscenes are played, it's better to disable Player movement (so 
that when the cutscene is active all player inputs, such as moving around, will be 
disabled) and HUD and all that. To do these, select the M atinee Actor in world and 
then in the D etails panel, you can set the necessary options. 
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a) Details ® World Settings 
Search 
> Transform 


4 Matinee Actor 


Matinee Data InterpData_O 


4 Play 
Play Rate 
Play on Level Load 
Looping 
Skip Update if Not Visible 


ls Skippable 


4 Rewind 
Rewind on Play 
No Reset on Rewind 
Rewind if Already Playing 
4 Cinematic 
Disable Movement Input 
Disable Look at Input 


Hide Player 


Level: Testmap (Persistent) 


Hide Hud 





Summary 


Matinee is avery powerful tool to create in game cinematics. With multiple cameras 
and other visual/ audio effects, you can create good-looking and professional 
cinematics. Since you learned how to manipulate objects and cameras in this chapter, 
you should now try to create an elevator movement with a camera that acts asaCCTV. 
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Unreal Motion Graphics 


Unreal M otion Graphics (UM G) is a User Interface (UI) authoring tool that 

is used to create in game H eads up Display (H UD s), Main Menu, and other UI 
elements. They are created using a special blueprint called Widget Blueprint, which 
contains various predebned widgets that you can use to construct your interface. 
Let's take a look at UMG now. 


In this chapter, you will learn how to create UMG Widgets and assign one to 
our character to display his health. You will also learn how to create yoating 
health bars. 


Setting up a project 
To get started, start Unreal Engine 4 and create a new project based on Third 
Person Template. 
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Since we are going to havea HUD with a health bar, let's add anew health variable 
to our Third Person Character Blueprint. Open up the ThirdPersonC haracter 
Blueprintin theThirdPersonBP/ Blueprints folder: 


4 Variables 
> My Character 
Basel urnRate 


BaseLookUpRate 


Event Dispatchers 


a) Details 

search 

4 Variable 
Variable Name 
Variable Type 
Editable 
Tooltip 
Expose on Spawn 
Private 
Expose to Matinee 
Category Default 


Slider Range 


li ELT LI 
| | : j 


Value Range 


Replication 


a 
= 
i) 

4 


4 Default Value 


Health 


g 
© 





Inside our character Blueprint, create a new variable called H ealth and follow 
these steps: 


Å Setthevariabletypetof! oat and giveit a default value of 100. The next step 
is to create a Pure function that shows the percentage of the total health of 
the player. 
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Inside your Character Blueprint, create a new function (for example, 
G etH ealthPercentage) and open it. 


In the function graph, get your health variable and divide it by the default 
value of health. By doing so, we will get the percentage of our player health. 
To get the default value of any variable in your class, just right-click in graph 
and search for G et Class D efaults. This node will return all the default 
values of the variables you created. 


N ow, create a new output for this function (yoat type) and connect the result 
(divide node) to this output. This function will now return the percentage of 
your player health. For example, if your player's health is 42, then dividing it 
by 100 (default health value) will return 0.42. Wecan use this information for 
our progress bar in HUD as well as the yoating health bar. 


The resulting Blueprint function should look like this: 


We Get Cass Befouks 





N ote that it is very important to set the output name 
A> to ReturnValue. 


We will now create a UMG Widget and make use of this function to display the 
player's health. 
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Creating the HUD Widget 


To create a new Widget Blueprint: 


Å Right-click on Content Browser 
Å Select Widget Blueprint under the User Interface section: 


H+ Class 
E New C++ Class 
l Import to /Game... 


Blueprint Class 


os 4 Level 
=== Material 


+ Farticle System 
a AD amc ei AS 
Animation 
Blueprints 
Materials & Textures 
Sounds 
Physics 
PS) Font 
Miscellaneous 


Blendables oR 
g Slate Brush 
Paper2D a 


ificial Intelligence eee 
Artificial Intelligence a A Slate Widget Style 
ia a 
MT 
pren 


The widget blueprint enables extending UUserWidget the user extensible UWidget. 
hold (Ctrl + Alt) for more 





Once you select that, anew Widget Blueprint will be placed in Content Browser and 
it prompts you to enter anew name. For this example, | named it My UMG_ HUD. 
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Double-click on My UMG_HUD to open it: 





No Animalon Selected 


Widget Blueprint User Interface 


This is Widget Blueprint. This is where you create the UI for your game. Let's take a 
closer look at Widget Blueprint UI: 


A 


A 
A 
A 
A 
A 
A 


Toolbar: This is the common toolbar that lets you Compile, Save, Play, and 
Debug your graph. 


Editor M ode: This lets you switch between the Designer mode and the 
Graph mode. 


Visual Designer: This is the main area where you drag and drop all the 
widgets to create your UI as it appears in the game. 


Palette: This is the list of widgets that you can drag and drop into Visual 
Designer. This will also list any custom widgets you have created. 
Hierarchy: This displays the structure of this widget. You can drag and drop 
widgets in this too. 

Animation List: This lets you create new Animation Tracks, which you can 
use to animate various properties of widgets. 


Animation Track Editor: After creating anew Animation, you can select that 
Animation and create key frames here. 


Since we will be using this as our player HUD, let's create a progress bar that shows 
the player's health. 
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Creating the health bar 


From the Palette window, drag and drop the Progress Bar widget on to the Visual 
D esigner. Once placed on the Visual Designer, you can resize it to any size you 
want. You can also place it anywhere, but, for this example, | decided to keep it at 
the bottom-left corner of the screen. 


When you select the Progress Bar widget, you will see all the properties that you can 
edit in Details Panel including the name of your Progress Bar. For this example, | 
have changed the name of our progress bar to H ealthBar. The Progress Bar widget 
offers a variety of settings that you can change Including the look and feel. 


The following screenshot is from the health bar that | have just placed: 


a) Details 


Œ] HealthBar Is Variable Open ProgressB 
p 


4 Slot (Canvas Panel Slot) 

> Anchors Anchors 
Position X 
Position Y 
Size X 


Size Y 


< 
> 
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> Alignment 
Size To Content 
ZOrder 

4 Style 

4 Style 
> Background Image 
> Fill Image 
> Marquee Image 

4 Progress 


Percent 


Bar Fill Type Left to Right v 
ls Marquee 
4 Appearance 
> Fill Color and Opacity 
4 Behavior 
Is Enabled 
Tool Tip Text 


Visibility Visible 


4 Performance 
Is Volatile 
4 Render Transform 


> Transform 


a < E ` & 
4| H 
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> Navigation 
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Let's take a quick look at some of the common settings that you will change: 


Anchors: These depne the location of the widget and maintain it for varying 

screen sizes. By default, there are 16 anchor positions and, typically, one of these is 
suffcient for most needs. But there are times where you have to adjust the Anchor 
position manually. For example, if your game has an inventory system where the 
player can dynamically resize the contents, then you need to tweak the Anchor 
position manually. For this example, we will set the Anchor position to the lower-left 
corner of the screen. 


A 


> > > To 


Position X: This positions the widget on the X Axis. (horizontal). 
Position Y: This positions the widget on the Y Axis. (vertical). 
Size X: This scales the widget on the X Axis. 

Size Y: This scales the widget on the Y Axis. 


Alignment: This is the pivot point of the widget. Setting both X and Y to 
0.0 will set the pivot point to the upper left corner and setting both to1. 0 
will set the pivot point to the lower-right corner. You can use the alignment 
option with Anchors to precisely set a widget to the center of the screen. 
For example, you can set alignment (both X and Y) to0. 5 and Anchors to 
the center and set both position X and Y to0. 0. This will bring your widget 
exactly to the center of the screen. This can be used for setting a crosshair. 


Size to Content: If enabled, this widget will ignore Size X and Size Y values 
and, instead, scale according to the Widget content. For example, if your 
widget is a Text Block, then it will scale automatically according to the 

size of the given text. 


ZOrder: This depnes the render priority for this widget. Higher priority 
widgets are rendered last, which makes them appear on top of other widgets. 


Style: This depnes the look and feel of this widget. N ote that each widget 
has its own unique style settings (you can either use a Texture or M aterial 
to use as an image for your widget). If it's a progress bar widget, then style 
category will let you change the progress bar pll image, background image, 
and marquee image. If it was a button, then you can change the image of the 
button based on the button state. For example, Normal state, H over state, 
Pressed state, and so on. 


Percent: This pills the progress bar with the given value. It ranges from 0-1. 
In this example, we will use the H ealth Percentage of our character to drive 
this value. 
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Å Bar Fill Type: This depnes how the progress bar plls. For example, from left 
to right, right to left, from the center, and more. 


Å Is Marquee: This enables the marquee animation progress bar. This means that 
the progress bar will show activity but does not indicate when it will stop. 


Å Fill Color and Opacity: This depnes the color and opacity for the pll image of 
the progress bar. 


Now that we know the Progress Bar settings, let's continue and assign the H ealth 
Percentage of our character to the health bar we created. To do that, prst let's switch 
our Editor mode to Graph mode by clicking on the Graph button on the top-left 
corner of Widget Blueprint. Once you click, you will see the Blueprint graph editor 
for this widget. 


On the left side of the widget Blueprint, you will seethe My Blueprint tab. As you 
have learned previously in the chapter on Blueprints, this is where you create your 
variables. So let's create a new variable (I named it My Character ) and set the type 
for our Third Person Character. See the following screenshot for reference: 


© EventTick third person character x 


Funeti (33 Over : 
UNCTIONS (33 C A Object Types 


Macros Í » > 
4 Variables HEEE 


heahea | I Asset ID 


My Character BAPI 
F | ) Class Asset ID 
Event Dispatchers 


Reference an instanced object of type ‘Third Person Character’ 


4“) Details 


4 Variable 


Variable Name 


Variable Type b Third Person Ci + 
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Once you create that, go back to the D esigner mode and select your Progress 
Bar. In the Details Panel, you can see a Bind option near the Percent value. 
When you click on it, you will see a new dropdown menu that shows our newly 
created My Character variable. Move your mouse over it and you will see the 

G etPlayerH ealthPercentage function, which we created previously: 


4 Progress 
Bar Fill Type Leftto Right Create Binding 


Is Marquee [| sub-Object Properties 
Functions 
4 Appearan f 


> Fill Color ar 





Once you click on that, it will set the H ealth Percentage value from our character to 
the progress bar. 


If you don't see your character variable in the Bind dropdown, make 
sure you compiled the Widget Blueprint. 


Assigning our HUD to Character 


Now that we have pnished setting up the HUD, it is tt me we assign it to the character. 
Let's close Widget Blueprint for now and open ThirdPersonC haracter Blueprint. 


Inside our Character Blueprint, open the Event Graph and: 
Å Right-click and, from the resulting context menu, search for Event BeginPlay 
and select it. 


Drag a wire from the execution pin of Event BeginPlay and release the 
mouse button. From the context menu, search for Create Widget and select it. 


A 
Å Inthe Create Widget node, select MyUMG_HUD in theciass pin. 
A 


From the Return Value of the Create Widget node, drag anew wire and 
release the mouse button. From the context menu, search for Set My 
Character and select it. 


Å Right-click on the graph editor and search forse! f and select Get a reference 
to self. Connect this node to the M y Character pin. 


[175 ] 


Unreal Motion Graphics 


Å Again, drag a wire from the Return Value of the Create Widget node and 
search for Add to Viewport. 


Å Connect the output execution pin of the Set M y Character node to the input 
execution pin of Add to Viewport. 


The resulting graph should look like this: 


SET 
© Event BeginPlay Gm Create My UMG HUD Widget = -p b 


e eral 
3 È b ia My Character 


Class Return Value Target 
My UMG HUD ~ 


Owning Player 





Now, if you play the game, you will see the health bar plled completely: 





If your health bar is still empty, make sure you set the output name of 
J G etH ealthPercentage to ReturnV alue. 
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To test it, we can create a new function called D ecrementH ealth and create a graph 
like this: 


fe Decrement Health F Branch : H P Set Timer by Function Name 
$ True > — —_- p> D 


Condition False > @ Health » Object Return Value 


Function Name 
[ DecrementHealth | 


@ Time 


e 
Ie er @ bad Looping O 
= 
Health @ 


f Random Float in Range 


© Min [1] Return Value @ ©} Decrement Health 


© Max {3 | 


za mamm — > 
es eng ye e Health , welll 
E Get Class Defaults © è Target | self | 
Class Base Turn Rate ©» 
. Base Look Up Rate O» 
Health @ 


After that, drag and drop this function from your M y Blueprints tab and connect it 
after the Add to Viewport node. Now, if you start playing, you will see the player 
health going down randomly. 


Etgcvpi 'Sacvoi 'j gcnj ‘dctu 


In this section, you will learn how to create a yoating health bar above the character's 
head. Let's go back to Content Browser and create a new Widget Blueprint (for this 
example, I'll name it M yFloatingH ealthbar) and open it. 





In the Designer tab, you can see an option called Fill Screen at the top-right corner 
of the visual designer. Click on that and change it to Custom: 


A Details 
| 4 [1E Screen size~ | Fill Screen ~ 
# Fill Screen 
Custom on Screen 
Desired 


Desired on Screen 
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The Custom mode will let you assign the width and height of this widget. Let's set 
the width and height to 256 and 32. Now, wewill drag and drop anew Progress Bar 
into the visual designer and use the following settings: 


4 Slot (Canvas Panel Slot) 


Position X 
= = 


Position Y 
size X 
size Y 
> Alignment 
size To Content 


Z Order 


ai Style 


> Style 
4 Progress 
Percent 


Bar Fill Type 





Set the Anchors to the very last anchor (this is the Fill Anchor). Anchor helps the 
widget stay in its position with different screen sizes. This avoids the widget being 
cropped off the screen. In addition to the pll anchor, there are other preset anchors 
too, such as pll bottom left side, pil right side, pil bottom area, pil top area, top left, 
center, right corners, and more. Based on the position of your widget, you can select 
any Anchor you want and, in the game, the widget will be positioned relative to the 
Anchor position. 


In this example, since we set the anchor to pll, Position X and Y and Size X and Y 
will be replaced with Offset Left, Top, Right, and Bottom respectively. Change the 
Offset Right and Bottom to0. 0. The Progress Bar will now be properly stretched 
to the width and height of the visual designer. 


Now, let's create a new variable called M y Character with the type set to your 
ThirdPersonC haracter Blueprint and bind the Percent value to your character's 
G etH ealthPercentage function. This is the exact same step we performed for our 
HUD Widget. 
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After setting the percent value, let's close this Widget Blueprint for now and open 
ThirdPersonC haracter Blueprint. Switch to the Viewport tab and click on Add 
Component in the Components tab and select Widget Component: 


-*_ Components 


+ Add Component ~ 


r cy r mts 


wa FAWN NOISE EMITIET 
@, Pawn Sensing 


Audio 
® Audio 
Basic Shapes 
@ Sphere 
© cube 
P cylinder 
À Cone 


Leek eT a 
% Camera 
@ Spring Arm 
Collision 
: W Box Collision 
| ® Capsule Collision 
_ @ Sphere Collision 
Experimental 
@, Procedural Mesh 
© Widget 
Gameplay | asks 
@, Gameplay Tasks 
LeapMotion 


® Leap Motion Controller 





Once you select it, this widget component will be added to your Player Character. 
Select the newly added Widget Component and in Details Panel, set the Draw Size 
to the same size we used for our M yFloatingH ealthbar, which was 256 and 32. And 
then set the Widget Class to M yFloatingH ealthbar class and set Space to Screen. 
Finally, move the Widget to your desired location. In this example, I've set it above 
the character's head. 
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For reference, here is the screenshot: 


=. Components 
+ Add Component ~ 
P ThirdPersonCharacter(self) 


a l CapsuleComponent (Inherited) 
R, ArrowComponent (Inherited) 
t Mesh (Inherited) 
4@CameraBoom 
t- FollowCamera 
& Widget 


Pa CharacterMovement (Inherited) 


‘Add New ~ EE 
4 Graphs 
la EventGraph 
a Functions (37 
*r ConstructionScript 
f GetPlayerHealthPercentage 
f DecrementHealth 
Macros 


p aji tel e 


> Variable 

> Transform 

> Sockets 

4 User Interface 
Space 


Widget Class 


> Draw Size xX 256 a Ya2 he 
> Pivot 
Max Interaction Dist 





If you play now, you will see the health bar yoating on top of the player's head but 


it will be empty. This is because we haven't assigned the M y Character value to our 
yoating health bar. To make it work: 


1. Switch to the Construction Script tab. 


2. Right-click anywhere on the Construction Script tab, search for G et Widget, 
and select it. 
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3. Drag anew wirefrom the Widget node you just created, search for G et User 
Widget O bject, and select it. 


4. Drag anew wire from Get User Widget Object Return Value pin, search for 
Cast to M yFloatingH ealthbar, and select it. 


5. Connect the output execution pin of Construction Script to this newly 
created C ast node. 


6. From the output pin (such as My Floating H ealthbar) drag anew wire and 
search for Set M y Character and select it. 


7. Connect the unnamed output execution pin of the Cast node to the Set My 
Character node. 


8. Right-click on the graph editor, search forse! f , and select Get a reference 
to self. Connect this node to the M y Character pin. 


That's it! Now if you press play, you will see your character's health bar yoating on 
top of your player's head: 





Summary 


UMG can be used to create a wide variety of UI effects. From here, you can extend 
this by adding a player portrait image next to your yoating health bar or givea 
weapon to your character and show the ammo count for that weapon and more. 
You can also add the Widget component to other actors in your game (for example, 
a treasure chest) that shows information about that actor. Renember that laying out 
your UI in Visual Designer is only the beginning. To make your UI look good, you 
have to change the look and feel by changing the style of your widgets. 
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Particles in Unreal Engine 4 are created using cascade particle editor, which isa 
powerful and robust editor that allows artists to create visual effects. Cascade editor 
lets you add and edit various modules that make up the þnal effect. The primary job 
of the particle editor is to control the behavior of the particle system itself whereas 
the look and feel is often controlled by the material. 


In this chapter you will learn about the cascade particle editor and create a simple 
particle system. 


Cascade particle editor 


To access cascade particle editor, you need to create a Particle System in Content 
Browser by right-clicking on the Content Browser and selecting Particle System. 
When you select it, anew Particle System will be created and it prompts you to 
rename it. Give ita name and double-click on it to open cascade particle editor. 
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Once you open it you will see a window like this: 


VU ape 


— a 
mh ote oc SR pee Ur |) ee 


= Tapii © 





Cascade Editor User Interface 
Cascade particle editor consists of bve primary areas and they are: 


Å Toolbar: This contains visualization and navigation tools 
Viewport: This shows the current particle system 
D etails: This lets you edit the current particle system, emitter, or modules 


Emitters: These are the actual particle emitters and contain modules that are 
associated with the emitter 


Do De Do > 


Curve Editor: This is the editor that lets you modify properties in either 
relative or absolute time 


Toolbar 


Toolbar contains various buttons. Let's take a quick look at them: 


Å Save: This saves the particle system 
Å Find in CB: This locates the current particle system in Content Browser 
Å Restart Sim: This restarts (resets) the current simulation 
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Restart Level: This is the same as Restart Sim but will also update all the 
instances placed in level 


Thumbnail: This saves the viewport view as a thumbnail for 
Content Browser 


Bounds: This enables or disables rendering of particle bounds 
Origin Axis: This displays the origin axis in viewport 


Regen LOD: Clicking on this generates the lowest LOD duplicating the 
highest LOD 


Regen LOD: Clicking on this generates the lowest LOD using values based 
on the highest LOD 


Lowest LOD: This switches to the lowest LOD 

Lower LOD: This switches to the next lowest LOD 

Add LOD: This adds anew LOD before the current LOD 
Add LOD: This adds anew LOD after the current LOD 
Higher LOD: This selects a higher LOD 

Highest LOD: This selects the highest LOD 

Delete LOD: This deletes the current LOD 


> > Jo >œ To To D> > > > D> D> 


J 


LODs are ways to update the particle effects to use efpcient screen space depending 
on player distance. Based on the effect, there can be modules in a particle system that 
can be too small to render if the player is far away. Imagine bre embers. If the player 
is far away, the particle system will still process and calculate these effects which we 
don't need. This is where we use LODs. Level of D etail (LO Ds) can turn off specipc 
modules or even shut down the emitter based on player distance. 


Viewport 

Viewport shows you the real-time changes made to the particle system as well as 
other information's, such as total particle count, bounds, and so on. On the top left 
corner, you can click on the View button to switch between various view modes, 
such as Unlit, Texture Density, Wireframe mode, and so on. 
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Navigation 


Using the following mouse buttons you can navigate inside the viewport: 


Å Left M ouse Button: This moves the camera around the particle system. 
M iddle M ouse Button: This pans the camera. 

Right M ouse Button: This rotates the camera. 

Alt + Left M ouse Button: This orbits the particle system. 


Alt + Right M ouse Button: This dollies the camera forward and backward 
from a particle system. 


F: This focus on the particle system. 


Joo > > >œ Jo To 


L + Left M ouse: This rotates the light and only affects particles using Lit 
material. Unlit materials have no effect. 


Inside the Viewport, you can play/ pause the particle simulation as well as adjust the 
simulation speed. You can access these settings under the Time option in Viewport. 


Be VWiewpor 


view J Time 


Wl Play/Pause 


W Realtime 
Wl Loop 
AnimSpeed 
è 100% 
ogs 
25% 
10% 
T% 
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Details 

The Details pane! is populated by the currently selected module or emitter. The 
main properties of the particle system can be accessed by selecting nothing in the 
Emitters panel or by right-clicking on the Emitter list and navigating to Particle 
System | Select Particle System. 


= Emitters 


Panicle Enter 


AE 


Emitter 


TypeData 
YP Add New Emitter Before 
Acceleration ; 
l Add New Emitter After 
Attraction 
Remove Duplicate Modules 


zw 


Camera 





Collision 


Emitter 


The Emitter panel! is the heart of the particle system, and contains a horizontal 
arrangement of all the emitters. In each emitter column, you can add different 
modules to change the look and feel of the particles. You can add as many emitters 
as you want and each emitter will handle different aspects of the pnal effect. 


= Emitters 


Reiriel Speier 


AB 2 


spawn 


Lifetime 
initial Size 
Initial Velocity 


Color Over Life 
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An Emitter contains three primary areas, and they are as follows: 


Å On top of the emitter block are the primary properties of the emitter, such as 
name, type, and so on. You can double-click on the gray area to collapse or 
expand the emitter column. 

Å Below that, you can define the type of emitter. If you leave it blank (as in the 
preceding screenshot), then particles are simulated on the CPU. 

Å Finally, you can add modules to define how particles look. 

Emitter types 


Cascade editor has four different emitter types, and they are as follows: 


A 


Beam Type: When using this type, the particle will output beams connecting 
two points. This means you have to define a source point (for example, the 
emitter itself) and a target point (for example, an actor). 


GPU Sprite: Using this type lets you simulate particles on the GPU. Using 
this emitter lets you simulate and render thousands of particles efficiently. 


M esh Type: When using this, the particle will use actual Static M esh 
instances for particles. This is pretty useful for simulating destruction effects 
(for example, debris). 

Ribbon: This type indicates that the particle should be like a trail. This 
means, all particles (in order of their birth) are connected to each other 

to form ribbons. 


Curve editor 


This is the standard curve editor that lets the user adjust any values that need to 
change during the particle's lifetime or across the life of an emitter. To learn more 
about curve editor, you can visit the ofpcial documentation available atht t ps: / / 
docs.unrealengine.com/latest/INT/Engine/Ul/CurveEditor/index. htm. 


Creating a simple particle system 


To create a particle system: 


L. 
2. 


Right-click on Content Browser. 
Select Particle from the resulting context menu. 
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3. A new particle system asset will be created in Content Browser and prompts 


4. 
5. 


you to rename It. 
For this example, let's call it M yExampleParticleSystem. 
Now, double-click on it to open the Particle editor. 


By default, Unreal creates a default emitter for you to work with. This emitter 
contains six modules, and they are: 


A 


A 
A 
A 


A 


Required: This contains all the properties required by the emitter, such as the 
material used to render, how long the emitter should run before looping, can 
this emitter loop, and so on. You cannot delete this module. 


Spawn: This module contains the properties that determine how the particles 
are soawned. For example, how many particles to soawn per second. You 
cannot delete this module. 


Lifetime: This is the lifetime of the soawned particles. 


Initial Size: This sets the initial size of particles when spawning. To modify 
the size after soawning, use Size by Life or Size by Speed. 


Initial Velocity: This sets the initial velocity (speed) of particles when 
Spawning. To modify the velocity after soawning, use V elocity/Life. 


Color over Life: This sets the color of a particle over its lifetime. 


For this example, we will modify the existing emitter and make ita GPU particle 
system that looks like sparks. We will also add collisions so that our particles collide 
with the world. 


Creating a simple material 


Before we start working with particles, we need to create a simple material that we 
can apply to the particles. To create a new material: 


L 


Right-click on Content Browser and select M aterial. Feel free to name it 
anything. 


Open Material editor and change Blend M ode to Translucent. This is 
required because GPU particle collision will not work on opaque materials. 


Then, change Shading M odel to Unlit. This is because we don't want the 
Sparks to be affected by any kind of light sincethey are emissive. 


[ 189 ] 


Partides 
4. Finally, create a graph like this: 


Texture Sample A 


& Details 


search OD o- 


4 Physical Material i @ Emissive Color 
Phys Material None 4 @ Opacity 
4 Material 


Material Domain Surface w | 


Blend Mode 

Decal Blend Modi [i ansit sių Particle Color imi sear E e S 
Shading Model pror _ Multiply Y 
Two Sided B r A S 
Use Material Attr 9 


© World Position Offset 


Subsurface Profil 


4 Translucency 
Screen Space Re § © Refraction 
Lighting Mode 


Directional Lighti §) 





N ote that the circular gradient texture in the Texture Sample 
J node comes with the Engine itself. It's called G reyscale. 


Now that we have our material, it's time to customize our particle system: 


1. Select the Required module and under the Emitters group, apply our 
material created in the previous step. 


2. Right-click on the black area below the emitter and select New GPU Sprites 
under Type Data. This will make our emitter simulate particles on GPU. 


= Emitters 


SPANKS 
= 204 


Emitter 
Heni oe 
pees Particle System 
pow 
Lifetir 
oF Acceleration 
Initial 
Attraction 


Typ eData 
New AnimTrail Data 


New Beam Data 
Color eee 
Camera 


Consi New Mesh Data 


Collision 
Sphet color , New Ribbon Data 
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3. Select the Spawn module and under the Spawn group, set Rate to 0. 
This is because instead of spawning a certain amount of particles per second, 
we want to burst hundreds of them in one frame. 


4. Under the Burst group, add anew entry in Burst List and set Count to 100 
and Count Low to 10. This will select a random value between 100 and 10 
and will spawn that many particles. 


The final Spawn settings will look like this: 


f) Details 


Search 


4 Spawn 


al Rate 
4 Distribution 
Constant 
Can be Baked 
a Rate Scale 
4 Distribution 
Constant 
Can be Baked 
Apply Global Spawn Rate Scale 
Process Spawn Rate 
4 Burst 
Particle Burst Method 
4a Burst List 1 elements 
d 0) 3 members 
Count 
Count Low 
Time 
[> Burst Scale 


Process Burst List 
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5. After adjusting the Spawn settings, we set the Lifetime of the particles to 0.4 
and 3.0, so each spawned particles’ lifetime is between 0.4 and 3.0. Now that 
we have particles soawning, it's time to adjust their size. To do so, select the 
Initial Size module and set M ax to 1.0, 10.0, 0.0 and Min to 0.5, 8.0, 0.0. 


4 Size 


al Start Size 
4 Distribution K) Distribution Vector Uniform 
b Max 
b Min 


> Mirror Flags 3 elements 


Use Extremes i 


Can be Baked 





N ote that since GPU sprites are 2D, you can ignore the Z value. 
J That's why we se them to 0.0. 


6. After that, select the Initial Velocity module and set M ax to 100.0, 200.0, 
200.0 and M in to -100.0, -10.0, 100.0. 


7. Now, if you drag and drop this particle into the world, you will see the 
particles bursting into the air. 


N ote that if you see nothing happening, make sure Real-Time is 
J turned on for the editor (Ctrl +R). 
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Adding gravity 
In order to make things a bit more real, we will simulate gravity on these particles. 
Go back to your particle editor and follow these steps: 


1. Right-click on the module area. 


2. Select Const Acceleration from the Acceleration menu. This module will add 
the given acceleration to the existing acceleration of particles and updates the 
current and base velocity. 


= Emitters 
sparks 
AEJ 
GPU Sprites 

| Fiaryurar 
Spawn 
Lifetime 
Initial Size 
Initial Velocity 


Color Over Life 


Emitter 
Particle System 


TypeData 


Attraction Drag 


Collision Drag Scale/Life 





Partides 


3. For the Acceleration value, use 0.0, 0.0, -450.0. A negative value of Z 
(that is, -450) will make the particles go down as if they are affected 


by gravity. 


N ote that the default gravity value is -980.0. You can try 
this value as well. 





Now, if you look at the particle in world, you can see them going down as if they are 
affected by gravity. 
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Applying the color over life module 


Now that we have something like sparks, let's apply some color to it. Select the Color 
Over Life module and apply the settings shown here: 
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Color Over Life is a curve value. It means you can depne what color to apply ata 
certain point in the lifetime of particle. The 0.0 value is the beginning and 1.0 is the 
end. In the preceding screenshot, you can see! have applied a bright reddish orange 
color (50.0, 20.0, 8.0) when the particle is spawning (In Val =0.0) and bright white 
color at the end (In Val =1.0). 


Adding collision module 


To complete this effect, we will add a Collision module so that our particles will 
collide with the world. To add the Collision module, go through the following steps: 


1. Right-click on the modules area and select Collision from the 
Collision menu. 


2. Select the Collision module. 
3. Set the Resilience value to 0.25. This will make the collided particles less 
bouncy. Higher resilience means more bouncy particles. 


4. Set Friction to 0.2. This will make the particles stick to the ground. 
A higher friction value (1.0) will not let the particle move after colliding, 
whereas lower values make the particle slide along the surface. 


Now, if you simulate or play the game with this particle in the world, you can see It 
bursting and colliding with the world but it's very unrealistic. You can easily notice 
that every second this particle keeps repeating. So to prevent this, follow these steps: 
1. Open the particle editor. 
2. Select the Required module. 


3. Under the Duration settings, set Emitter Loops to 1. By default, this is set 
to 0, which means it will loop forever. 


T Details 


> Emitter 

4 Duration 
Emitter Duration 
Emitter Duration Low 
Emitter Duration Use Range 
Duration Recalc Each Loop 


Emitter Loops 
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Playing particle in Blueprints 


N ow that our particle effect is ready, let's play it using Blueprints: 


1. Right-click on Content Browser. 

Select the Blueprint class. 

From the resulting window, select Actor. 
Double-click on the Blueprint to open the editor. 
Select your bursting particles in Content Browser. 


Open the Blueprint editor and add anew Particle System Component (if 
you select the particle in Content Browser, it will automatically set that 
particle as the template for the Particle System Component). 


Go to the Event Graph tab. 


Right-click anywhere on the graph and select Add Custom Event... from the 
Add Event category. 


Au FW N 


go N 


All Actions for this Blueprint Context Sensitive 


Select a Component to see available Events & Functions 


> Actor 
> Add Component 
4 Add Event 
> Actor 
> Collision 
> Game 
> Mouse Input 
> Touch Input 
Add Custom Event... 
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© Event Destroyed 
© Event End Play 
€> Event Tick 
b Al 
> Animation 
> Audio 
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9. Renamethat Custom Event with any name you like. For this example, | 
renamed it ActivateParticle. 


10. Create a graph like this: 


‘© Activate Particle 
© Event BeginPlay 


© ActivateParticle : (1) 
f Delay 


J Activate "© Activate Particle 


>— »b Completed > È > — >» 
» Duration Target Target [self] 
"F Random Float in Range : Reset A 

Min [0.2] Return Value 


» Max [2 | f ' D 
a PS Particle System 





This Blueprint will þrst execute A ctivateParticle when the game begins and when 
the event is executed, it randomly selects a time (in seconds) between 0.2 and 2. 
When the time runs out, it activates the particle and calls this event again. 


Now, if you drag and drop this particle into the world and start playing, you will see 
the particles randomly bursting: 
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Summary 


From here, you can extend this particle and add some lights to make it look even 
more real. N ote that the Light module cannot be used with GPU particles so you 
need to create another emitter and add a light module there. Since you learned about 
the GPU particle data type, you can add more and more emitters that use other data 
types, such as beam type, mesh type, ribbon type, and so on. From what you learned 
in this chapter and other chapters, you can create a Blueprint that includes a light 
mesh that emits this spark particle effect when it receives damage. 


In the next chapter, we will dive into the world of CH. 


[ 199 ] 





10 


Introduction to Unreal C++ 


In Chapter 6, Blueprints, you learned about Blueprints, the visual scripting language 
of Unreal Engine 4. Now you will learn about C-+4, which can be used to create base 
classes for Blueprints. In this chapter, you will learn how to create a C+ project 

(we will usethe Third Person Template) and modify it to add support for health and 
health regeneration for our character. You will also learn how to expose variables 
and functions to Blueprint. 


This chapter will be focused on writing C++ code using Visual Studio 2015 in 
Microsoft Windows. 


5 y v 
Ugwpi 'wr 'XluwcnUw 109'"4237 
With Unreal Engine 4.10, you will need Visual Studio 2015 to compile C + for your 
projects. There are three editions of Visual Studio available. They are: 
Å Community edition: This is free for any individual and nonenterprise 
organizations for up to five users. For this book, | will be using this edition. 
Å Professional edition: This is a paid version and is useful for small teams. 
Å Enterprise edition: This is for large teams working on projects of any size 
and complexity. 


You can download the Visual Studio 2015 community edition fromht t ps: // www. 
visual studio. com downloads/download-visual-studio-vs 
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After visiting the above link, select Community 2015 and choose your format 
to download. You can either download the web installer or the ofyine installer. 
To download the ofyine Installer, select the ISO format: 





Visual Studio downloads 


Visual Studio 2015 Visual Studio Community 2015 with Update 1 - Free 


Visual Studio Community 2015 with Update 1 is a free, fully featured, and extensible IDE for individual developers, 


a Community 2015 





open source projects, academic research, education, and small professional teams. Create applications for 
Enterprise 2015 Windows, Android, and iOS as well as web applications and cloud services. Build apps for any platform. Use 
Professional 2015 designers, editors, debuggers, and profilers in a single tool. Access thousands of extensions and more. 
Test Professional 2015 These cumulative updates to Visual Studio 2015 include a variety of bug fixes and capability improvements. To 
Bipra 2015 for Daip find out what's new in Visual Studio 2015 Update l. see the Visual Studio 2015 Update 1 Release Notes. For a list 
of fixed bugs and known issues, see the Visual Studio 2015 Update 1 MSDN Article. 
Express 2015 for Web 
a A EE AS 1 displays in the Notifications Hub. To install, select the notification, and then complete the installation actions. 
Visual Studio 2015 Update 1 You can also download Visual Studio 2015 Update 1 here. 


Note: If you have Visual Studio Community 2015 (original release version) installed and run the download from 


Team Foundation Server 2015 this page, only Visual Studio 2015 Update 1 is installed. If you don't have it installed and run the download, both 
Visual Studio Community 2015 and Update 1 are installed. In either instance, Visual Studio 2015 Language Packs 
Visual Studio Code (original release versions) can also be installed. 
Tools for Visual Studio 2015 Release notes 
System requirements 
Visual Studio 2013 Compatibility 


SHA-1 values 
Compare Visual Studio editions 





Team Foundation Server 2013 


Tools for Visual Studio 2013 Choose language: | English : 


Visual Studio 2012 Choose format: F® Web installer SO 


Top Third-Party Extensions 


.NET Framework 





Visual Studio Community 2015 with Update 1 — Free - English 











After downloading the setup, double-click on vs_community.exe to run the setup 
and install Visual Studio 2015. 


> Before installing Visual Studio 2015, make sure you select Visual C ++ 
under the Programming Languages section. This is required to work 
with Unreal Engine 4. 
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04] Visual Studio 


Community 2015 


Languages 


Setup requires up to 10 ME across all drives 





When the installation is complete, the setup will prompt you to restart your 
computer. Do this, and you are good to go with Unreal Engine 4 C+. 


Y qtnsaqy ‘lo r tqxgo gpw 
There are some recommended settings for Visual Studio 2015 to work with Unreal 
Engine 4 that improves the overall user experience for developers. Some of them are: 


Å Turn off Show Inactive Blocks. If you do not, many chunks of code may 
appear grayed out in the text editor. (Tools | Options | Text Editor | 
C/C++ | View). 
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Å Set Disable External D ependencies Folders to True to hide unneeded 
folders in the Solution Explorer. (Tools | Options | Text Editor | C/C++ | 
Advanced). 


Å Turn off Edit & Continue features. (Tools| Options | Debugging | Edit 
and click on Continue). 


Å Turn on IntelliSense. 


Creating a C++ project 


Now that we have Visual Studio installed, let's create a project that includes C++ 
code. In this project, we will extend the Third Person Template that comes with 
Unreal Engine 4 and add support for health (including health regeneration): 


AL Unreal Project Browser 


Projects New Project 


Choose a template to use as a starting point for your new project. Any of these features can be added later by clicking Add Feature or Content Pack in Content Browser 


FÔ Blueprint ee 


Per - 

2o : @ 

Basic Code First Flying Rolling Side 
Person Scroller 

m ae 

T eae Soe = 
T R á — Fe \ 5 iC SZ 
— 


2D Side Top Down Twin Stick Vehicle Vehicle 
Scroller Shooter Advanced 


Third Person 


The third person template features a playable character where the camera is 
positioned behind and slightly above the character. As the character moves using 
mouse, keyboard, controller or virtual joystick on a touch device, the camera follows 
tha aharantanr t mann tearm a ar h nrharldar nnin* nf irin Thie narenarti 


Choose some settings for your project. Don't worry, you can change these later in the Target Hardware section of Project Settings. You can also add the Starter Content to your project later 


using Content Browser 
| v ‘7 x v A v 
Eos 


Desktop / Console Maximum Quality No Starter Content 


Select a location for your project to be stored 


DAUnreal Projects z 


Narine 


Greate Project 
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Start Unreal Engine 4 and when the project browser dialog appears: 


Å Select the New Project tab 

Å Select the C ++ sub tab 

Å Select Third Person 

A Nameyour project 

Å Click on Create Project 
When you click on Create Project, Unreal Engine 4 will create all the base classes 
required and will compile the project for you. This might take a minute or so. 


Once this is completed, the solution ble (Visual Studio ple) for your project 
will be automatically opened along with the project. 


Once the project is opened, one main change you might notice is the new Compile 
button that appears on the Toolbar. This will only appear if your projectisa 
code project: 


| K m sP- tod Mey = =] 
= ® ki = p awe g | = CN .  —_ ia | s jen 7 


Save Source Control Content Marketplace Settings Blueprints Matinee Build Compile Play Launch 





This is used to recompile the code changes and reload them on the yy, even when 
you are playing the game! This system is called Hot Reloading. As a programmer, 
you will make use of this feature extensively. 


The character class 


In this project, we havea character class and a game mode class already available. 
Let's take a quick look at how the character class is made. 


Basically, what we have is a source ble (with the extension. c pp ) and a header ple 
(. h). In anutshell, a header ple contains all the declarations, and the source ple 
contains the depnitions of those declarations. To access a specifc method (or a 
function) in another ble, weuse# incl ude Examp! eHeader. h. This way, wewill 
have access to all functions declared in that header ple. 


Accessing declarations on another header ble are based on access specibers. We will 
learn more about them later in this chapter. 
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To open the source ple (. cpp) and header ple (. h ) from Unreal Engine 4: 


Å Open Content Browser 

A Goto C++ Classes 

Å Select your project name folder 

Å Doubleclick on your character class 


This will open both source ple (. cpp) and header ple (. h ) in Visual Studio: 


BQ) PACKT. CPP - Microsoft Visual Studi = 


File Edit View VAssistX Project Build Debug Team Tools Test Analyze Window Help 
o - D- So ke a Œ ~ þ Local Windows Debugger ~ Auto ~ DebugGame Editor 
Fc - PACKT_CPP ~ "§(SolutionDir)$(ProjectName).upr ~ ty Build Startup Project — 


-> PACKT_CPPCharacter.h ~ - > D:\Unreal Projects\PACKT_CPP\Source\PACKT_CPP\PACKT_CPPCharacter.h 
(| PACKT_CPP . (Global Scope) 


1340/dx4 13M5 


xoqjooj 


= (AllowPrivateAccess = “true")) 


= (AllowPrivateAccess = “true”)) 


100% ~ 4 


Error List Code Definition Window Output Find Symbol Results 


p 


asm m| 


x 


Satheesh ~ z 


shejysey yA səaipədoid MAA sse Jasojdxz wea; 1310/dx3 UONJOS 
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The preceding screenshot shows the header ple of our character class. Let's analyze it 
line by line. 


A 


#pragma once: Any linethat is preceded by a hash (#) sign is called a 
preprocessor directive. Think of it as instruction to the compiler to run before 
any actual code is compiled. They start with the hash (#) sign and usually 
ends with a new line. You can have multi-line by using the backslash (\ ) sign. 
In this case, #pragma once isa preprocessor and Its job is to protect against 
multiple includes. #pragma once iSknown as header guard. 


#i ncl ude:In this file, we see two includefiles. OneisCharacter.h from 
theGameFramework folder (which isin theUE4 directory) and the other is 
agenerated.h file 


° Character. h: This fileis included because our character class is 
inherited from theAChar acter class that comes with Unreal Engine 
4. This include is required to access all the declarations in the 
Character Class. 


° generated. h: Thisis automatically generated for you by Unreal 
Header Tool (UHT). These are generated whenever you havea 
USTRUCT() Or UCLASS() macro declared. They contain the details of 
type declarations in your header file. This should be the last include 
filein your header. 


Macros:Macros arealso preprocessor-directive, which starts with #defi ne. 
Right before the compile time, the compiler copies and pastes the actual 
values anywhere this macro is used. For example, if you create a macro 
likethis: #define MyMacro 3.14,then3. 14 will becopied and pasted 
everywhere that My Macro iS used. 


UCLASS( conf ig=game) : Thisisan Unreal macro that makes the editor aware 
of the new class. Inside the parentheses, you specify the class specifiers and 
metadata. In this example, we specify the config specifier. This indicates that 
this class is allowed to store data in the given configuration file. In this case, 
the name of your config filewill beYour GameNameGame.i ni. 


class APACKT CPPCharacter:public ACharacter: Thisindicates the class 
name and shows you which class we inherited this from. For this class, we 
inherited itfromtheCharacter class. 
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Å GENERATED. BODY() : This isa macro that must be placed at the very 
beginning of the class body. When compiling, Unreal will reolace it with 
all the boilerplate code that is necessary. This means that, right before 
compile time, GENERATED BODY() is replaced by the actual code. Since this 
chunk of code is required to compile the class, Epic has made it easier for us 
by creating this macro. 


Å private,public,andprotect ed: These are called access specifiers. Access 
specifiers let you decide whether a method can be accessed by other files or 
not. There are three types of access specifiers. They are: 


° private: This means you can access the members only in this class. 
In this example, Camer aBoom and Fol! owCamera areset as private 
properties. That means, you can access them on! y inside this class. 
If you create a new class deriving from this class, you cannot 
access them. 


° publ ic: This means all the members can be accessed from any 
other class. 


° protected: This means all the members can be accessed from this 
class and any class that is derived from this class. 


Å UPROPERTY() : This defines the property metadata and specifiers. These are 
used on properties to serialize, replicate, and expose them to Blueprints. 
There areanumber of UPROPERTY () specifiers that you can use. To see the 
full list, visit this link: https: //docs.unrealengine. com latest/INT/ 
Programming/ Unreal Architecture/Reference/ Properties/Specifiers/ 
index.html. 


Å void: This means it's a function that does not return any data type A 
function can return any type of data such asf !oat,int,bool , or even 
objects, but doesn't require a data type all the time. In such cases, you would 
use the void return type to indicate that this method does not return any type 
of data. This will also prevent overriding the function in any child classes. 

If you want to override a function in child classes, then you need to make 
it a virtual void. When you create a virtual void, it means child classes can 
override this function, implement their own logic, and optionally call the 
parent class function using the keyword Super. 


Understanding the preceding things (preprocessors, macros, access specibers, and so 
on) will help alot as you work in Unreal C. 
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Another thing that is worth mentioning is the use of double colons (: : ), hyphen 
arrows (- >), and periods (. ). Understanding what they are and how to use them is 
crucial. Out of these, mostly we use the hyphen arrow (- >) symbol. Let's see what 
they are. 


Å Doublecolons (: : ): When using this symbol, it means you are accessing a 
method from a specific namespace or scope. For example, you will use this 
symbol when you want to call static methods from other classes. 


Å Hyphen arrow (- >): This is used when you are pointing to some data that 
might or might not exist somewhere in the memory. Using this symbol 
means you are trying to access a pointer. A pointer points to alocation 
somewhere in the memory where the actual data of that pointer is stored. 
Before accessing a pointer, it is always a good idea to check them and make 
sure they are valid. Pointers are one of the most important part in Unreal 
C++s0 I'd highly recommend to read this article provided by Nathan lyer 
(Rama): https://wiki.unrealengine.com/Entry Level Guide to. 

UE4 C%2B%2B#Poi nters 


Å Period (.): This is used to access the data itself. For example, you will use this 
to access the data Inside a struct. 


Adding the health system 


Now that we know about theChar acter class, let's begin by modifying our character 
to add support for the health and health regeneration system. Before we begin, let's 
see a quick breakdown of what we will be doing. In this system: 


A Afloat variablethat holds the current health of the player when the game 
begins. We will make sure that the player has maximum health when the 
player is initialized. 


Å Overridethe default functionTakeDamage () of theActor Class. 


Å When the player is taking damage, we will check how much damage was 
taken and subtract that amount from the health. We will then start a timer 
that will execute an event that regenerates health. 


Creating a health variable 
So let's get started. Open up your character source ble and add the following code 
under private access speci þer: 


UPROPERTY( EditAnywhere, BlueprintReadWrite, Category = "My 
Character", meta = (AllowPrivateAccess = "true") ) 
float Health; 
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Here, wedeclareaHeal th variable with the data typef | oat . We also added 
UPROPERTY toourf| oat variable and added the specibersEdi t Anywhere, 

Bl ueprintReadWrite, andCategory. TheEdi t Anywhere Speciber lets you edit 
this property in the Details panel. Bl ueprint ReadWri te allows you to get or set 
this value in Blueprint. Whatever name you write as the category will appear in the 
D etails panel. If you compile and start your game and look at the D etails panel of 
the ThirdPersonC haracter Blueprint (in ThirdPersonC PP/Blueprints) you will see 
our new property exposed: 


om conter ji BI OV Se] AL ag a ne 


File Edit Asset View Debug Window Help 


Ta Search Folders suustcillaai ; | A 
4 Content za A 

> i Geometry 

> fi Mannequin 

irdPers 


Compile Save Find in CB 


NOTE: This is a data only blueprint, so only the default values are shown. 


b am Thir 


b Activation 
> Variable 
a My Character 





As you can see, a value of 0. 0 doesn't make sense to Heal th. So what we will dois 
open the source ple of our character class and type the following line under the class 
constructor: 


Health = 100.f; // .f is optional. If it's confusing you can replace 
it with 100.0 


Theconstructor class is usually the prst depnition in a source ple. It looks like 
YourClassName:: YourClassName(). 


Any line preceded by / / (double slash) is a comment and is ignored 
Js by the compiler. 


Theconstructor class is basically where we set the default values of our class. In 
this case, we want the default value of our player health to be100. 


Now, if you press the Compile button in Unreal Engine editor, the editor will 
compile the new changes and hot reload it when it's pnished. When the compilation 
is bnished, you should see the new value (which ts 100) as the default value for 
health. 
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Taking damage 


Now that our health is set, we can access it and change itin ourcharacter class. 
We now need to update this value whenever our player is taking damage. Since our 
character isan Actor class, we can use theTakeDamage() function to update the 
health. To do so, add the following code to your character header ple: 


virtual float TakeDamage( float Damage, struct FDamageEvent const & 
DamageEvent, AController* Eventi nstigator, AActor* DamageCauser ) 
override; 


TakeDamage isa virtual function that already exists in theAct or class. 
So when you want to have custom logic inside virtual functions, make 
> sure you include an override keyword for them. This way you are telling 
the compiler to look in the parent class for a depnition of this function. In 
case if the base class depnition could not be found or has been changed 
then the compiler will throw an error. Keep in mind that if the override 
keyword is not there then the compiler will treat this as anew debpnition. 


TheTakeDamage function takes some parameters and returns af | oat value, which 
is the actual damage applied. In this function, we will frst check whether our health 
value is larger than 0. If itis, we decrease the Heal th value by theDamage value. If 
not, then wesimply return 0: 


float APACKT CPPCharacter::TakeDamage(float Damage, struct 
FDamageEvent const& DamageEvent, AController* EventIlnstigator, AActor* 
DamageCauser) 


{ 
// Super key word is used here to call the actual TakeDamage function 


fromthe parent class which returns a float value. We then assign this 
value to ActualDamage which is a float type. 


const float Actual Damage = Super::TakeDamage(Damage, DamageEvent, 
Eventi nstigator, DamageCauser) : 
// Check if we have health 
if (Health > 0.0) 
{ 
|| Reduce health by the damage received 
Health = Health - Actual Damage; 
|| return the actual damage received 
return Actual Damage; 
} 
|| Player has no health. So return 0.0 
return 0.0; 


} 
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In the preceding example, you can see the use of comments and how it can help 
when reading the code later. Take Damage function prst calls the parent class function 
which returns the actual damage to apply. We will save this value to a local variable 
called Act ual Damage. We then check whether thehea! th valueis greater than 0. 0 
and if itisthenheal th valueis reduced by theAct ual Damage yoat variable and 
return that value. Whenever you override a virtual function and implement your 
custom logic, you useSuper:: FunctionName() to inherit the basic functionality of 
the parent class. Since theTakeDamage() function is virtual, and we override that 
function, weuseSuper:: TakeDamage() to call the actual function depned in the 
parent class, which does the logic of applying damage to the actor. 


Health regeneration 


N ow that our character can take damage, we will modify this system further and add 
health regeneration. Our health regeneration system will regenerate health based 
onaf! oat variable that is by default setto 1.0 every 1second, which is also set to 
afloat variable. These settings will be exposed to the Blueprint editor, so we can 
change them later without compiling the game again. 


Let's take a quick look at the health regeneration system: 


A Weusea timer to regenerate health. 
When the player takes damage, we clear this timer. 


A 

Å After taking damage, we set the timer to restart after 2 seconds. The timer 
will call a custom function that will regenerate health. 

A 


When the timer finishes, it will call the custom event which will add 1 health. 
This timer will continue to run until the player reaches maximum health. 


So the prst thing we need iS aTi mer Hand! e. This helps in identifyingTi mers that 
have identical methods bound to them. To declareaTi mer Hand! e, open up the 
character header ble and add the following line under GENERATED BODY (): 


FTi mer Handle TimerHandle Healt hRegen; 


You can use any nameforTi mer Hand! e. Here, the use of 
j Ti mer Handl e_ beforeHealthRegen is optional. 
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Since we now know that we will be using timers, let's add two new f | oat variables 
that will act as the timeto activate theRegenerat eHeal th function: 


A Wewill call thefirstf! oat variable! ni tial Del ay. Thisis used to call 
Regenerat eHealth after taking damage. We will set the default value to 2. 


A Wewill call the second f | oat variableRegenDel ay. When regenerating 
starts from theTakeDamage function, weusethisRegenDel ay timeto call 
theRegener at eHeal th function again. We will set the default valueto0. 5. 


The following are the variables: 


|* After taking damage, Regenerate Health will be called after this 
much seconds. */ 


UPROPERTY( EditAnywhere, Category = "My Character" ) 
float Initial Delay; 


/* Time to regenerate health. */ 
UPROPERTY( EditAnywhere, Category = "My Character" ) 
float RegenDel ay; 


We will also add anew property called RegenerateAmount and expose it to the 
Blueprint editor: 


UPROPERTY( EditAnywhere, BlueprintReadWrite, Category = "My 
Character", meta = (AllowPrivateAccess = "true") ) 
float RegenerateAmount ; 


IntheRegenerat eAmount variable you can see anew meta speciber called 
All| owPrivateAccess. Thisis used when you want a variable in private 
access speciper but you need it in Blueprint as well (Bl ueprint ReadOnly or 
Bl ueprintReadWrite). WithoutAl | owPrivateAccess compiler will throw 
an error when you useBl ueprintReadWrite orBl ueprintReadOnly ona 
variable under private access speciber. Finally, we will add a new function 
called Regenerat eHealth likethis: 


void RegenerateHealth(); 


For now, we are done with the header ple. Let's open the character source ble and 
inside the class constructor (remember the class constructor isYour ClassName: : You 
rClassName() ), add the default valuefor RegenerateAmount aSl.0. 


Theconstructor cassis not construction script in Blueprints. 
If you want construction script behavior in C+, then you need 
i to overridetheOnConstruction method. 
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We will also add theRegener at eHeal th function into our source ple like this: 


void APACKT CPPCharacter::RegenerateHealth( |} 
{ 
} 


Inside this function, we will write our code that will add theRegener at eAmount 
value to our existing health. So let's modify it like this: 


void APACKT CPPCharacter::RegenerateHealth( |} 


{ 
if (Health >= GetClass()->GetDefaultObj ect <ABaseCharacter>()- 
>Heal th) 


{ 

Health = GetClass()->Get Default Obj ect <ABaseCharacter >()- 

>Heal th; 
} 
else 
{ 

Health += RegenerateAmount ; 

FTi mer Handle TimerHandle ReRunRegenerat eHealth: 

Get Worl dTi merManager().SetTimer( Ti merHandle_ 
ReRunRegenerateHealth, this, &APACKT CPPCharacter:: Regenerat eHealth, 
RegenDelay ); 

} 
} 


Now, let's analyze that code. The prst thing we do inside this function is to check 
whether our Heal th is greater than or equal to our default Heal th. If itis, wesimply 
set the health value to the default value (which is what we set in the constructor). 

If it's not, weadd Regener at eAmount to our existing health and rerun this function 
using a timer. 


Finally, we modify theTakeDamage function to add Heal t hRegener ati on: 


float APACKT CPPCharacter::TakeDamage( float Damage, struct 
FDamageEvent const& DamageEvent, AController* Eventi nstigator, AActor* 
DamageCauser ) 


{ 
|| Get the actual damage applied 

const float Actual Damage = Super::TakeDamage( Damage, DamageEvent, 
Eventi nstigator, DamageCauser); 


if (Health <= 0.0) 


{ 
|| Player has no health. So return 0.0 
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return 0.0; 


} 


|| Reduce health by the damage received 
Health = Health - Actual Damage; 


Iiis the health reduced to 0 for the first time? 
if (Health <= 0.0) 
{ 


|} Clear existing timer 
Get Worl dTi merManager().ClearTi mer( Ti merHandle HealthRegen) ; 
Pe CU OOD 


} 


// Set a timer to call Regenerate Health function, if it is not 
running already 
if (!GetWorldTi merManager().IsTimerActive(Ti merHandle HealthRegen) ) 


{ 
Get Worl dTi merManager().SetTimer(TimerHandle HealthRegen, this, 
SAPACKT CPPCharacter::RegenerateHealth, Initial Delay): 


} 


|| return the actual damage received 
return Actual Damage: 


} 


In the code above, we prst check if our health is less than or equal to 0. 0. If itis then 
we know the player has no health so we simply return 0. 0. Otherwise we reduce 
ourheal th value and check if health is less than or equal to 0. We clear the timer if 
health is0 otherwise we check if health regeneration is currently active. If it is not 
active then we create a new timer to run theRegener at eHeal th function and lastly 
wereturn theAct ual Damage applied. 


C++ to Blueprint 


We now havea health and health regeneration system in our character class. One 

problem with our current system is that we have not yet depbned what happens to 
our character after the health reaches 0. In this section, we will create an event that 
we will implement in Blueprint. This event will be called when the player's health 
reaches 0.0. To create this Blueprint event, open our character header ble and 

add the following code: 


UFUNCTION( Blueprint!l mpl ementableEvent, Category = "My Character") 
void PlayerHealthlsZero(); 
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As you can see, we added anormal function called P| ayerHealthisZero().To 
make this available in Blueprint, we added aUFUNCT! ON speciber and inside that we 
added Bl uepri nti mpl ementabl eEvent . This means C++ can call this function and it 
will execute inside Blueprint but we cannot add a depnition for this in our character 
source ble. Instead, we will just call it inside the source ble whenever we want. In 
this example, we will call it inside our TakeDamage event if the player's health is0. 
So let's modify our TakeDamage like this: 


float APACKT CPPCharacter::TakeDamage( float Damage, struct 
FDamageEvent const& DamageEvent, AController* Eventi nstigator, AActor* 
DamageCauser ) 

{ 
|| Get the actual damage applied 

const float Actual Damage = Super::TakeDamage(Damage, DamageEvent, 
Eventi nstigator, DamageCauser) : 


if (Health <= 0.0) 

{ 

// Player has no health. So return 0.0 
return 0.0; 


} 


|| Reduce health by the damage received 
Health = Health - Actual Damage; 


lils the health reduced to 0 for the first time? 
if (Health <= 0.0) 
{ 
// Clear existing timer 
Get Worl dTi merManager().ClearTi mer( Ti merHandle HealthRegen) ; 


// Call the BLueprint event 
PlayerHealthisZero(); 


return 0.0; 


} 


// Set a timer to call Regenerate Health function, if it is not 
running already 
if (!GetWorldTi merManager().IsTimerActive(TimerHandle HealthRegen) ) 


{ 
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Get Worl dTi merManager().SetTimer(Ti merHand!le HealthRegen, this, 
GAPACKT CPPCharacter::RegenerateHealth, Initial Delay): 


} 


// return the actual 
return Actual Damage: 


damage received 


In the preceding code, we call PlayerH ealthlsZero right after clearing the 


regen timer. 


Now it's time to compile and run the project. In Visual Studio, press F5 to compile 
and launch the project. Once the project is loaded, open our character Blueprint and 
you will see our new variables exposed in the D etails panal: 


Add New + 


Fig Search Folders 


aës Content 
> i Geometry 
b fi Mannequin 
> i ThirdPerson 
4 ie Thir C 


> Ea C++ Classes 


+, Import Save All 





EN [m i ee a 
: | f= Con u wMaiakeeoieiaratien 


File Edit Asset View Debug Window Help 


3 = 
v. ~ tm ? 

Compile Save Findin Cs 
NOTE: This is a data only blueprint, so only the default values are shown. 
Search 
Ae LW cl A 
> Variable 
a My Character 

Health 

Initial Delay 

Regen Delay 

Regenerate Amount 
> Clothing 
> Character Movement (General Settings) 
> Character Movement: Walking 
W Public View 
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From here, you can open the Blueprint graph and add our Player H ealth Is Zero 
event: 


All Actions for this Blueprint E Context Sensitive 


© Event Player Health Is Zero ( 


Select a Component to see available Events & Functions 


D 
> Actor 
D Add Component 
4 Add Event 
> Actor 
> Collision 
> Game 
> Mouse Input 
4 My Character 
© Event Player Health Is Zero 
> Pawn 
> Touch Input 
© Add Custom Event... 
© Event BeginPlay 
© Event Destroyed 
© Event End Play 
© Event On Landed 
© Event On Launched 





In this event, you can program your logic to play a death animation, show some 
UI screen, and so on. 


Summary 


Unreal C++ Is easy to learn compared to actual C+- This is because the 
programming wizards at Epic Games implemented so many features that makes 
writing Unreal C++fun! You can extend what you learned from this chapter 

by including Armor system, Stamina system, and so on for your character. By 
incorporating UMG and Blueprints, you can show a HUD that shows player health 
and maybe a small warning system that pops up when the player's health goes 
below 50. In the next chapter, you will learn how to package a project for shipping. 
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Packaging Project 


Throughout this book, you learned the basics of Unreal Engine 4. In this pnal 
chapter, we will recap all that, as well as see how to package your project into 
a standalone game. You will also learn how to package the game for quick 
distribution and package a game as a release version. 


Recap 


In the þrst chapter, you learned the difference between Unreal Engine versions. As 
| have mentioned, the launcher version is a binary version compiled by Epic and is 
ready for you to use. But, if you want to get the latest build that is not yet available 
through launcher, then your only choice is getting the source code from GitH ub. 

If you are going for the source code version of Unreal Engine then | recommend 
getting the source from the promoted branch. Epic works hard on the promoted 
build for their artists and designers, so most of the time it is updated daily and you 
get the latest stuff too! if you really want to get your hands dirty or you have that 
urge to grab the latest and the most cutting-edge build, then you should go for the 
master branch. Keep in mind that this branch tracks live changes directly from Epic, 
it might be buggy and it might even fail to compile. 


Once you get the engine up and running, you can start importing your assets into 
Content Browser. This is where you save and edit the assets that are used in your 
game. Content Browser offers a lot of functionality such as searching based on 
keyword, tags, asset type, þlters, etc. and you can use the Collections feature in 
Content Browser to add references to your most commonly used assets. When 
searching, you can exclude specipc keywords by adding the hyphen (-) before the 
name. For example, if you want to exclude all assets that contain the namef | oor, 
then you can search in Content Browser as- f | oor . This will show you all assets 
that do not contain the word yoor. 
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Another great feature of Content Browser is the D evelopers folder. This is especially 
useful when you are working in ateam where you want to try out different 
techniques or assets in your game without affecting other parts. One thing to 
remember is that you should only use this strictly for personal or experimental work 
and you should never include references to external assets outside this folder. For 
example, if you made an asset that you want to try out before adding it to the game, 
then you can create a test level inside your Developers folder and test out everything 
there. Think of the Developers folder as your own private playground where you 
can do whatever you want without affecting others work. The D evelopers folder 

IS not enabled by default. To enable it, click on View Options at the bottom right 
corner of your Content Browser and select Show D evelopers Folder: 


View Type 

@® Tiles 
List 
Columns 

Folders 


W) Show Folders 


_| Show Plugin Content 


Show Engine Content 


#| Show Collections 


Thumbnails 
Scale —J_ 
[ | Thumbnail Edit Mode 


W Real-Time Thumbnails 





<> View Options+ 
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Once you enable that, you will see a new folder called Developers under your 
Content folder in Content Browser: 


b Add New- J. Import Save All 


Search Folders 


4 i Content 
it Developers 


Db mes Ge o m e t ry 

> fi Mannequin 

a ThirdPerson 

l fi ThirdPersonCPP 
> Es C++ Classes 





The name of the folder inside the D evelopers folder is automatically set to your 
Windows username. If you are using Source Control (for example, Perforce or 
Subversion), then you can see the 0t her Developers folder by enabling the Other 
D evelopers checkbox available under Filters | Other Filters: 


G Ada N | rt [Save All | Artificial Intelligence + 
ews = Impo co Save - 


Pimia larnnra k Cathaankh 


| Checked Out 


Search Folders fe) VFilters~ Beene: | | Modified po 
a è Content 
m Developers Replicated Blueprints 


4 


| Show Redirectors 


D fim Geometry 

b fi Mannequin | In Use By Level 
b i ThirdPerson 

b BE ThirdPersonBP 


| Compare Tags (TagName != Value) 





lga C++ Classes Allow display of assets in developer folders that aren't yours. 


Knowing this will help you alot when you are working with a team or when you 
have lots of assets. 
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Just like how you use Content Browser to pnd assets that are imported, you use 
World Outliner to pnd assets that are placed in your level. You can also use Layers to 
organize assets that are placed in the level. Both of these windows can be summoned 
from Window in the menu bar: 


SEEN y 


u = fore eneiner = (ayers 


Search Layers 
& æ Editor stuff 
Lan < =æ Floor and Walls 
E Test_Map 
= © BP_Sky_Sphere 
z CameraActor i 
Æ DirectionalLight DirectionalLight 
Greeble_Morph StaticMeshActar 
Greeble_Morph2 StaticMeshActor 
Greeble_Morph3 | 
A Greeble_Morph4 StaticMeshActor 
Greeble_Morph5 StaticMeshActor 
Greeble_Morph6 
 Greeble Morph? 
} Greeble_Morphs 
Greeble_Morph3 I 
i $ Greeble Morph10 
Greeble_Morph11 StaticMeshActot 
} Greeble_Morph12 
Greeble_Morph1 3 I 
Greeble_Morphl4 | 
y Greeble_Morph15 
+ Greeble_Morph16 
Greeble_Morph1? I 
Greeble_Morph18 
Greeble_Morph13 statich >to 
fy Greeble_Test StaticMeshActar 
© Greeble Test? StaticMeshActor 


> View Options + 





In Chapter 3, M aterials, you learned about the awesome M aterial Editor and the 
common nodes that we will use. A good material artist can totally change the realism 
of your game. Mainly materials and post processing gives you the power to make the 
game look realistic or cartoony. The common material expressions that we learned 
are not just used for coloring your assets. For example, create the following material 
network and apply to a simple mesh (for example, a sphere) and see what happens: 
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M_Test 

©» Base Color 
© Metallic 
©» Specular 
©» Roughness 


©» Emissive Color 


VertexNormalWS v 


B 
PN Multiply v i Multiply v © Normal 
"nev A ®© — A @ —— ©@ World Position Offset 


“Multiply Y 
ply ® r De a ean B B 
e 


© Ambient Occlusion 


© Pixel Depth Offset 





If you pnd yourself using a specibc network multiple times, then it's better for you to 
create a material function which can tidy up your graph and make it more organized. 


As you continue developing your game, you will eventually start tweaking with Post 
Process Volume. This lets you modify the overall look and feel of your game. By 
combining Post Process in blueprints or C++ you can even use It to affect your game 
play too. A perfect example for this is the detective vision from the Batman Arkham 
series games. You can use materials in post process to highlight a speciþc object in 
world or even use it to render outlines for meshes that are behind other objects. 


Another crucial part of the game that determines the pnal look is lighting. In this 
book, you learned about different light mobilities, the differences between them 
including common light settings and how it affects the game world. You also learned 
about Lightmass Global Illumination which is the static global illumination solver 
developed by Epic Games. 
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As you know by now, Lightmass is used to bake lighting and because of that, dynamic 
lights are not supported by Lightmass. When using Lightmass for your game, you 
need to make sure that you have a second UV channa for all your static meshes (that 
are not set to movable) to have proper shadows. If you want to use dynamic lights 
(that means lights that can change any of their properties at runtime-think of the day 
and night cycle as an example), Epic has included support for Light Propagation 
Volume (LPV). At thetime of writing this book, LPV isin experimental stage and 

is not yet ready for production. One extra thing that is worth mentioning here is the 
ability to change bounced lighting color. Take a look at the following material network: 


f AGEMA M_Test 


@ Default $+ ® Base Color 

@ Staticindirect ©» Metallic 

© Dynamicindirect © Specular 
© Roughness 


O Emissive Color 


C Normal 
© World Position Offset 





Using the GIReplace material node, you can change the color of the bounced light. If 
you apply the preceding material to a mesh and use Lightmass to build lighting, the 
result of the bounced light will be red color instead of white. Even though we don't 
need to have a different color for bounced lights, we can still use this node to darken 
or brighten the bounced lighting without the need to adjust Lightmass settings. 


[224] 


Chapter 11 


Once we have all the base setups, we then jump to Blueprints. Blueprint Visual 
Scripting is a powerful and yexible node-based editor that lets artists and designers 
quickly prototype their game. Mainly, we work with two common Blueprint types 
and they are Level Blueprint and Class Blueprint. Inside these Blueprints, we 

have Event Graph, Function Graph, and Macro Graph. In Class Blueprints, we 

add components to depne what that Blueprint is and how they behave. Nodes in 
Blueprint have various colors applied to them to indicate what kind of node they are. 
Once you start using Blueprints, you will get familiar with all the node colors and 
what they mean. We saw how to create a Class Blueprint from an Act or class and 
how to spawn it dynamically in the game. We also saw how we can interact with 
objects in world through Level Blueprint. We placed triggers in the level and 

in Level Blueprint we created overlap events for these triggers and learned how 

to play a Matinee sequence. 


Matinee is one of the powerful tools in Unreal Engine 4 that is mainly used to 

create cinematics. You learned about Matinee UI and how to create a basic cut 

scene. Since M atinee is similar to other nonlinear video editors, it is easy for video 
editing professionals to get familiar with Matinee. Even though Matinee is used for 
cinematics, you can also use it for gameplay-related elements such as opening doors, 
elevator movement etc.. You can even use it to export your existing cinematics as 
image sequences or in the AVI format. 


After learning about Matinee, we continued to the next chapter to learn about Unreal 
M otion Graphics (UM G). UMG is a UI authoring tool developed by Epic. Using 
UMG, we created a simple HUD for the player and learned how to communicate 
with the player Blueprint to show a health bar for the player. We also made a 3D 
widget for the player that yoats on top of the character's head. 


Continuing from there, you learned more about the Cascade Particle System. You 
learned about Particle Editor and various other windows available inside Cascade 
Editor. After learning the basics, you created a basic particle system using GPU Sprites 
including collision. Lastly, we took the particle system to Blueprints and learned how 
to randomly burst the particles using Custom events and delay node. 


Finally, we dived into the magic world of C+. There you learned about various 
versions of Visual Studio 2015 and how to download Visual Studio 2015 Community 
Edition. Once we havethe IDE installed, we created anew C+ project based on 

the Third Person template. From there we extended it to include health and health 
regeneration for our character class. You also learned how to expose variables and 
functions to Blueprints and how to access them in Blueprints. 
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Packaging the project 

Now that you have learned most of the basics of Unreal Engine 4, let's see how to 
package your game. Before we package the game, we need to make sure that we set 
a default map for our game which will be loaded when your packaged game starts. 
You can set the G ame D efault M ap option from the Project Settings window. For 
example, you can set the G ame D efault M ap option to your main menu map: 


AL A 
File | Edit | Window Help 
a> Stoy u E P e 


*) Undo Edit Game Default Map 
8 Undo history Project Project - Maps & Modes 
Descripti efault maps, ge id other map rela tting 


‘be These settings are saved in DefaultEngine.ini, which is currently writable 


4 Default Maps 


idiquration | Game Default Map /Game/ThirdPersonBP/Maps/ThirdPersonExampleMap fv 
M, Editor Preferences Editor Startup Map /Game/Test_Map |. x] 
Volu | ra ¥ 


Alic| *# Plugins Al System 4 Local Multiplayer 





To set a default map for the game, please follow these steps: 


1. Click on the Edit menu. 

Click on Project Settings. 

Select M aps & M odes. 

Choose your new map in Game Default M ap. 


PWN 


Quick packaging 
Once you set the Game D efault M ap option, you need to select the Build 
Conbguration: 
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File | Edit Window Help 
Load and Save 
YA Mew Level... 
BB open Level... 
Mm Save 
Save As... 
À Save All Levels 
f> Open Asset... 
™ Save All 
Choose Files to Save... 
Connect To Source Control... 
project 
E New Project... 
Y$ Open Project... 
New C+ Class... 
ig 
Refresh Visual Studio Project 
Open Visual Studio 


Cook Content for Windows 


Import... 


Export All... 


Ff Recent Levels 
Y Recent Projects 


#9| Exit 
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ypty Actor 


ipty Character 


int Light 


yyer Start 


Android 
HTMLS 
10S 
Linux 
Windows 
Zip Up Project 
DebugGame 


oe ® Development 
Packaging Settings... ERN 


Supported Platforms... sipping 


here Trigger 


There are three types of build conpgurations available Packaging the project: 


A 


A 


DebugGame: This conbguration will include all the debug information. For 
testing purposes, you can use this conpguration. 


Devel opment : This conbguration offers better performance compared to the 
DebugGame conpbguration build because of minimal debugging support. 


Shi ppi ng: This should be the setting you should choose when you want to 


distribute the game. 


[227] 


Packaging Project 


Once you have selected your build conbguration, you can package your game from 
File | Package Project and then select your platform. For example, here is the option 
to package your game for Windows 64-bit: 


File | Edit Window Help 
Load and Save 

GA New Level... 

BB Open Level... 

mm Save 

B’ Save As... 

SÌ Save All Levels 

f$ Open Asset... 

= Save All 

Choose Files to Save... 

Connect To Source Control... 
Project 

W New Project... 

> Open Project... 

W New C++ Class... 

cial 

Refresh Visual Studio Project 

Open Visual Studio 


Cook Content for Windows 


Import... 
Export All... 


FÈ, Recent Levels 
% Recent Projects 


#9] Exit 





{pty Actor 


pty Character 


int Light 
ayer Start 


Android 

HTMLS5 

10S 

Linux | 

Windows (32-bit) 

Zip Up Project 
Build Configuration »} 
Packaging Settings... 


Supported Platforms... 


here Trigger 


Once you select that option, editor might prompt you to select a target directory 
to save the packaged game. Once you set the path, editor will start building and 
cooking the content for the selected platform. If the packaging is successful, you 
will see the packaged game under the target directory you set earlier. 
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Packaging the release version 


The previously mentioned method is for quickly packaging and distributing the 
game to end users. However the preceding method cannot build DLCs or patches 
for your game so in this section, you will learn how to create a release version for 


your game. 


To start let's prst open the Project Launcher window. Project Launcher provides 
advanced workyows to packaging your game: 


Au We projectaninetier 


ila MyProject ~ Y= Advanced 


IOS 


Firefox fas 
El 


z HTML5 
Launch 


DESKTOP-LOQC18A2 Variant ea] 
a 
~ 


WindowsNoEditor 


A All_iOS_On_DESKTOP-LQC18A2 


Launch 


Custom Launch Profiles 
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To create a custom launch proble, click on the plus (+) button as shown in the 
preceding screenshot. Once you click on that you will see a new window with 


new settings as follows: 


u WH Projecthaunetier 


Ww My Game 


My game that is built using Shipping configuration 


Build Do you wish to build? 
T EOR Shipping v. 


p Advanced Settings 


How would you like to cook the content? 


Cooked Platforms: 
W AllDesktop 

Æ WindowsClient 
WindowsNoEditor 
We Winaowsserver 
@ Windows 

® Android 

@ Android_AsTc 
W Android_ATC 
W Android_DxT 
Ø Android_ETc1 
E Android_ETc2 


Cooked Cultures 
| esa 
@ en-Tz 
W en-UG 
E en-UM 
en-US 
W en-US-POSIX 
Ø en-vc 
@ en-vG 
@ en-vi 
@ en-VuU 
Ø en-ws 


Cooked Maps: 
@ Show all Show cooked 


® No available maps were found. 


D Release / DLC / Patching Settings 


p Advanced Settings 


Package How would you like to package the build? 


In the preceding window, do the following: 


1. Enable the Build checkbox. 


2. Set the Build Conbguration option to Shipping. 
3. Set the dropdown to By the book. 





By the book w 


Select: All None 


Select: All None 
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4. In this example we selected WindowsN oEditor to test on Windows. 
5. Select the culture. This is used for localization. By default, en-US is selected. 


Once all those settings are done, expand the Release/D LC/Patching Settings and 
Advanced Settings sections: 


u MR Pro jcetheinetien 


My Game 


My game that is built using Shipping configuration 


ED. c 
@ es-419 
@ es-AR 
@ es-Bo 


Select: All None 


Cooked Maps: 
® Show all Show cooked 


@ No available maps were found. 


4 Release / DLC / Patching Settings 


Name of the new release to create 


2 


Base this release on a previous release, applys to new creating new releases / dic / patches. 


§ Generate patch 
@ Build dic 


Name of the dlc to build. 


@ include engine content 


4 Advanced Settings 


E Only cook modified content 
Compress content 
Save packages without versions 


Num cookers to spawn: 


Store all content in a single file (UnrealPak) 
Generate Chunks 
Ø Don't include editor content in the build 
> Http Chunk Install Settings 


ooKer Dula Contiguration: 


5 


Package How would you like to package the build? Do not package v 


Deploy How would you like to deploy the build? Do not deploy ~ 
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Inside those sections do the following: 


1. Enable Create a release version of the game for distribution. 
Set the name of the new release to 1.0. 

Enable Store all content in a single ble (Unreal Pak). 

Set the Cooker build conpbguration section to Shipping. 


Add the- stage command line as Additional Cooker O ption. N ote that 
you do not press enter after typing it. Simply click anywhere else to apply 
that command. 


m BW N 


After setting this, set the last two options of Package and Deploy to Do not package 
and Do not deploy respectively: 


Package How would you like to package the build? Do not package v 


Deploy How would you like to deploy the build? Do not deploy v 


Launch The build is not being deployed and cannot be launched. 
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Once all those are done, click on the Back button on the top right corner of the 
Project Launcher window and you will see your new prople ready to build: 


AL 


“ All_iOS_On_DESKTOP-LQC18A2 


IOS 


On Trex a] 
MR Jijel anneiar 


Y= Advanced 


Firefox e] 
z HTML5 > 5 


Launch 
DESKTOP-LQC18A2 


Variant | Default» | e] 
WindowsNoEditor ~~ 


Launch 


jont s 


Custom Launch Profiles 


A My Game 


My game that is built using Shipping configuration 
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Simply click on the Launch button, ProjectLauncher will build, cook, and package 
your game. This might take time depending on the complexity of your game: 


u 9 aenar 


Operation in progress 


Task Duration Status 


Verify profile settings 0:00:00 Completed 
Launching UAT... 0:00:04 Completed 


@ Build game for Win64 0:00:00 Busy 
Cook content for Win64 Pending 
UAT post launch cleanup Pending 


woe GIGIN. v anuatemiuLuvy. wyr an~ 
ProjectParams.ValidateAndLog: SkipCook=False 
ProjectParams.ValidateAndLog: SkipCookOnTheFly=False 
ProjectParams.ValidateAndLog: SkipPak=False 
ProjectParams.ValidateAndLog: SkipStage=False 
ProjectParams.ValidateAndLog: Stage=False 
ProjectParams.ValidateAndLog: bUsesSteam=False 
ProjectParams.ValidateAndLog: bUsesCEF3=False 
ProjectParams.ValidateAndLog: bUsesSlate=True 
ProjectParams.ValidateAndLog: bDebugBuildsActuallyUseDebugCRT=False 
ProjectParams.ValidateAndLog: Project Params *******#a«aes 
Project.Build: *********«* BUILD COMMAND STARTED **##««eea« 
UE4Build Build: XGE was requested, but is unavailable, so we won't use it. 
UE4Build.Build: TALLILLE LL! UE4Build: 
UE4Build.Build: srrrraerermrrrrrrra ForceMonolithic: False 
UE4Build.Build: #iirrrirririrrrrrrraas ForceNonUnity:False 
UE4Build.Build: trrrrrrrrrrrerrrrrerrrase ForceDebuginfo: False 
UE4Build. Build: **+***+++eewsseeteeeeeeee USeXGE: False 
UE4Build.Build: ****+**#eeexxeeeeeeeeeeee USeParallelExecutor: False 
Commandutils.Run: Run: C:\Program Files\Epic Games\4.9\Enqine\Binaries\DotNET\UnrealBuildTool.exe MyProject Win64 Shipping "C:\Users\Satheesh\Documents\Unreal Projects\MyProject\ 


cance 





If the packaging was successful, then you can see that in the ProjectLauncher window: 
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Uw 


Sk Dyujsett iinetier 


Operation finished. Completed: 5, Failed: 0, Canceled: 0 


BETS Duration Status 

Verify profile settings 0:00:00 Completed 
Launching UAT... 0:00:04 Completed 
Build game for Win64 0:01:26 Completed 
Cook content for Win64 0:00:39 Completed 
UAT post launch cleanup 0:00:00 Completed 


Status 
riwyce PIVY  roitwvittcat. VVUILTMCIGtYCr iMyCetnvue a iveyr iwyoer 
Project.LogDeploymentContext: RelativeProjectRootForStage = MyProject 
Project.LogDeploymentContext: RelativeProjectRootForUnrealPak = MyProject 
Project.LogDeploymentContext: ProjectArgForCommandLines = “C:/Users/Satheesh/Documents/Unreal Projects/MyProject/MyProject.uproject” 
Project.LogDeploymentContext: RuntimeRootDir = C:\Program Files\Epic Games\4.9 
Project.LogDeploymentContext: RuntimeProjectRootDir = C:\Users\Satheesh\Documents\Unreal Projects\MyProject 
Project.LogDeploymentContext: UProjectCommandLineArginternalRoot = ../../../ 
Project.LogDeploymentContext: PakFileinternalRoot = ../../../ 
Project.LogDeploymentContext: UnrealFileServerinternalRoot = ../../../ 
Project.CreateDeploymentContext: End Deployment Context 
PACKAGE COMMAND STARTED 
Project.Package: PACKAGE COMMAND COMPLETED 
CommandUtils.PrintRunTime: Run: Total 86s to run UnrealBuildTool.exe 
CommandUtils.PrintRunTime: Run: Total 39s to run UE4Editor-Cmd.exe 
Automation.Execute: BUILD SUCCESSFUL 
Automation.Execute: Script execution successful, exiting 
ProcessManager.KillAll: Trying to kill 0 spawned processes 
Program.Main: AutomationTool exiting with ExitCode=Error_Success 
Domain_ProcessExit 


“clear Log | Save og... J Run Done, 





You can pnd your packaged gamein your project folder under Saved | 
StagedBuilds | WindowsN oEditor folder. Now you can distribute this 
packaged game to other users. 


Summary 


Throughout this book, you learned the basics of Unreal Engine 4. We started this 
journey with you learning how to download the engine and saw how to import your 
own assets. From there you learned about M aterial Editor and its common aspects. 
Then you learned about Post Process, how to use lights and the importance of lights 
in video games. You also learned about Blueprints which is the visual scripting 
language of Unreal Engine 4. We continued our journey from Blueprints to UMG 
which you can use to create any kind of menu in the game. Since a game is nothing 
without visual effects and cut scenes, you learned about Cascade Particle Editor 

and Matinee. From there we dived into the world of C++to learn the basics of this 
awesome language. Finally you learned how to package the game and distribute 

it to others. 
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TakeD amage function 211 
Third Person Template 201 
Time Bar 151 
toolbar, cascade particle editor 
buttons 184, 185 
Toolbar panel 
about 36-38 
Livenodes 40 
Live preview 39 
Live update 40 


U 


Unreal Box (UB) 23 
Unreal Convex (UCX) 24 
Unreal Engine 4 
about 1 
AnswerHub, URL 236 
collision generator 24 
community, URL 236 
compiling 5 
Content Browser 11 
custom build, starting 5 
Details panel 14 
documentation, URL 236 
downloading 1 
exploring 5-7 
GitHub version 1 


GitH ub version, downloading 3 


launcher (binary) version 1 


launcher (binary) version, downloading 2 


launcher build, starting 5-8 
modes 10 


Ofpcial Twitch Streams, URL 236 


URL 2,3 
viewport toolbar 8, 9 
YouTube channel, URL 236 


Unreal Header Tool (UHT) 207 

Unreal M otion Graphics (UMG) 167, 225 
Unreal Sphere (USP) 24 

Unreal Units (UU) 22 


V 


viewport, cascade particle editor 
about 185 
navigation 186 
view port toolbar 
about 8, 9 
navigating 14 
URL 15 
Visual Studio 2015 
setting up 201-203 
URL 201 
workyow improvements 203 


W 
Widget Blueprint 167 
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Packt, pronounced 'packed', published its prst book, M astering phpM yA dmin for Effective 
M ySQL M anagement, in April 2004, and subsequently continued to specialize in publishing 
highly focused books on speciþc technologies and solutions. 


Our books and publications share the experiences of your fellow IT professionals in adapting 
and customizing today's systems, applications, and frameworks. Our solution-based books 
give you the knowledge and power to customize the software and technologies you're using 
to get the job done. Packt books are more speciþc and less general than the IT books you have 
seen in the past. Our unique business model allows us to bring you more focused information, 
giving you more of what you need to know, and less of what you don't. 


Packt is a modern yet unique publishing company that focuses on producing quality, 
cutting-edge books for communities of developers, administrators, and newbies alike. 
For more information, please visit our website at www. packt pub. com. 


Writing for Packt 


We welcome all inquiries from people who are interested in authoring. Book proposals should 
besenttoaut hor @packt pub. com. If your book idea is still at an early stage and you would 
like to discuss it prst before writing a formal book proposal, then please contact us; one of our 
commissioning editors will get in touch with you. 


We're not just looking for published authors; if you have strong technical skills but no writing 
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Learning Unreal Engine Android 
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Unreal Engine Game 


Development Cookbook 
ISBN: 978-1-78439-816-3 Paperback: 326 pages 
Over 40 recipes to accelerate the process of learning 


game design and solving development problems 
using Unreal Engine 


1. Explore the quickest way to tackle common 
challenges faced in Unreal Engine. 


2. Create your own content, levels, light scenes, 
and materials, and work with Blueprints and 
C+ scripting. 


3. An intermediate, fast-paced Unreal Engine 
guide with targeted recipes to design games 
within its framework. 


Learning Unreal Engine Android 
Game Development 
ISBN : 978-1-78439-436-3 Paperback: 300 pages 


Tap into the power of Unreal Engine 4 and create 
exciting games for the Android platform 


1. Divestraight into making fully functional 
Android games with this hands-on guide. 


2. Learn aboutthe entire Android pipeline, 
from game creation to game submission. 


3. UseUnreal 4 to create a þrst person 
puzzle game. 


Please check www.PacktPub.com for information on our titles 
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Unreal Engine Lighting and 
Rendering Essential 
ISBN : 978-1-78528-906-4 Paperback: 242 pages 


Learn the principles of lighting and rendering 
in the Unreal Engine 


1. Ge acquainted with the concepts of lighting 
and rendering speciþc to Unreal. 


2. Use new features such as Realistic Rendering 
and Foliage Shading to breathe new life into 
your projects. 


3. A fast-paced guide to help you learn lighting 
and rendering concepts in Unreal. 


Learning Unreal® Engine iOS 


Learning Unreal® Engine 
iOS Game Development 





Muhammad A.Moniem 


Game Development 
ISBN : 978-1-78439-771-5 Paperback: 212 pages 


Create exciting iOS games with the power 
of the newUnreal® Engine 4 subsystems 


1. Learn about the entire iOS pipeline, from game 
creation to game submission. 


2. Develop exciting iOS games with the Unreal 
Engine 4.x toolset. 


3. Step-by-step tutorials to build optimized 
IOS games. 


Please check www.PacktPub.com for information on our titles 


